sysPass is a secure password manager that lets you store and organize your passwords, web credentials, and other sensitive data. In this tutorial, we will walk you through the steps to install sysPass on the latest version of Fedora CoreOS.
Before you begin with this tutorial, make sure you have the following prerequisites:
The first step is to install the required dependencies for sysPass. To do this, enter the following command:
sudo dnf install -y nginx php-fpm php-common php-mysqlnd php-intl php-pecl-imagick php-opcache php-cli php-xml php-gd php-mbstring php-pdo
Next, download the sysPass archive from the official website using the following command:
wget https://github.com/nuxsmin/sysPass/archive/master.zip
Extract the downloaded archive using the following command:
unzip master.zip
Move the extracted files to the web directory using the following command:
sudo rsync -av sysPass-master /usr/share/nginx/
Now, configure Nginx to serve requests to the sysPass application. To do this, create a new Nginx configuration file using the following command:
sudo nano /etc/nginx/conf.d/syspass.conf
Paste the following configuration in the file:
server {
listen 80;
server_name your-domain.com;
root /usr/share/nginx/sysPass-master;
index index.php;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size= 100M";
}
location ~* \.(jpg|jpeg|gif|png|css|js|ico)$ {
expires max;
log_not_found off;
access_log off;
}
}
Replace your-domain.com with your domain name or IP address.
Save and close the file.
Reload Nginx for the changes to take effect using the following command:
sudo systemctl reload nginx
Now, create a new configuration file for sysPass using the following command:
sudo nano /usr/share/nginx/sysPass-master/system/config/config-user.inc.php
Paste the following configuration in the file:
<?php
$config = array (
'instance_name' => 'sysPass',
'admin_user' => 'admin',
'admin_pass' => 'password',
'admin_email' => 'admin@example.com',
'user_restriction' => '^[a-zA-Z0-9-_]+$',
'email_restriction' => '/^[^@\s]+@[^@\s]+\.[^@\s]+$/',
'apikey_length' => '32',
'user_salt' => 'ChangeMe',
'ldap_active' => false,
'ldap_server' => '',
'ldap_port' => '',
'ldap_starttls' => false,
'ldap_binddn' => '',
'ldap_bindpassword' => '',
'ldap_dn' => '',
'ldap_firstname' => 'givenName',
'ldap_lastname' => 'sn',
'ldap_email' => 'mail',
'ldap_groups' => 'memberOf',
'smtp_active' => false,
'smtp_server' => 'localhost',
'smtp_port' => '25',
'smtp_from' => 'syspass@example.com',
'smtp_auth' => false,
'smtp_user' => '',
'smtp_password' => '',
'recaptcha_active' => false,
'recaptcha_sitekey' => '',
'recaptcha_secretkey' => '',
'shortcuts' =>
array (
'show' => 'true',
'generate' => 'true',
'history' => 'true',
'import' => 'true',
'export' => 'true',
'api' => 'true',
'ldap-link' => 'false',
'delete' => 'false',
'edit' => 'false',
'favorites' => 'false',
'add-direct' => 'false',
'checkout' => 'false',
'checkin' => 'false',
'add-password' => 'false',
'add-note' => 'false',
'add-username' => 'false',
'add-url' => 'false',
'add-email' => 'false',
'add-creditcard' => 'false',
'add-ssn' => 'false',
),
);
?>
Save and close the file.
Set the necessary permissions on the sysPass files using the following commands:
sudo chown -R nginx:nginx /usr/share/nginx/sysPass-master/
sudo chmod -R 755 /usr/share/nginx/sysPass-master/
Open your web browser and visit the URL http://your-domain.com . You will be redirected to the sysPass login page. Enter the username and password specified in the configuration file in step 5 to access your sysPass account.
In this tutorial, we explained how to install sysPass on the latest version of Fedora CoreOS. Now, you can securely store and manage your passwords and other sensitive data using sysPass.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!