sysPass is a password manager and access control system that is easy to use and secure. In this tutorial, we will explain how to install sysPass on Debian Latest.
Before you begin, you should have the following:
First, update your system and install the Apache web server and PHP 7.2 or later:
sudo apt-get update
sudo apt-get install apache2 php7.4 libapache2-mod-php7.4 php7.4-mysql php7.4-json php7.4-gd php7.4-curl php7.4-mbstring php7.4-intl php7.4-xml
Once installed, start the Apache web server by running:
sudo systemctl start apache2
sudo systemctl enable apache2
Next, install the MySQL or MariaDB database server:
sudo apt-get install mysql-server
During the installation process, you will be prompted to set a root password for the MySQL database.
After installation, start the MySQL service and enable it to start on boot:
sudo systemctl start mysql
sudo systemctl enable mysql
Then, log in to MySQL using the root password you created earlier:
sudo mysql -u root -p
Create a new database for sysPass:
CREATE DATABASE syspass;
Create a new MySQL user and grant it privileges to the syspass database:
CREATE USER 'syspassuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON syspass.* TO 'syspassuser'@'localhost';
FLUSH PRIVILEGES;
Replace password
with a strong password.
Exit the MySQL console:
exit;
Download the latest release of sysPass from the official website:
wget https://github.com/nuxsmin/sysPass/archive/master.zip
Unzip the archive and move the extracted folder to your web server directory:
unzip master.zip
sudo mv sysPass-master /var/www/html/syspass
Change the owner and group of the sysPass directory to the Apache user and group:
sudo chown -R www-data:www-data /var/www/html/syspass
Rename the .env.example
file to .env
:
cd /var/www/html/syspass
sudo cp .env.example .env
Edit the .env
file with your favorite text editor:
sudo nano .env
Change the following configuration settings:
APP_NAME="SysPass"
APP_URL=http://yourdomain.com/syspass
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=syspass
DB_USERNAME=syspassuser
DB_PASSWORD=password
Save and close the file.
Generate a new application key:
php artisan key:generate
Run the database migrations:
php artisan migrate
Create a new virtual host configuration file for sysPass:
sudo nano /etc/apache2/sites-available/syspass.conf
Add the following lines to the file:
<VirtualHost *:80>
ServerName yourdomain.com
ServerAdmin webmaster@localhost
DocumentRoot /var/www/html/syspass/public
<Directory /var/www/html/syspass>
AllowOverride All
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Replace yourdomain.com
with your actual domain name.
Save and close the file.
Enable the virtual host:
sudo a2ensite syspass.conf
Reload the Apache web server for the changes to take effect:
sudo systemctl reload apache2
Open a web browser and go to http://yourdomain.com/syspass
. You should see the sysPass login page.
Log in with the default username admin
and password admin
.
Now you have installed sysPass on Debian Latest. You can use sysPass to manage your passwords and access control securely. To learn more about sysPass, visit the official website.
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!