Installing Passbolt on Linux Mint

Passbolt is an open-source, self-hosted password manager specifically designed for teams. In this tutorial, you will learn how to install Passbolt on Linux Mint.

System Requirements

Step 1 - Install Apache

Passbolt is a web-based application that requires a web server to function properly. In this tutorial, we will be installing Apache, however, you're free to use any web server of your choice.

To install Apache, run the following command:

sudo apt update 
sudo apt install apache2

Once the installation is complete, you may start the Apache service using the command:

sudo systemctl start apache2

Step 2 - Install PHP

Passbolt requires PHP to run. We will be installing the latest version of PHP.

Run the following command to install PHP and other required extensions:

sudo apt-get install php php-common php-pear php-mysql php-cli php-zip php-curl php-xmlrpc php-gd php-mbstring php-xml libapache2-mod-php

Step 3 - Install MySQL

Passbolt requires a database to store its data. In this tutorial, we will be using MySQL.

Run the following command to install MySQL along with PHP's MySQL extension:

sudo apt-get install mysql-server php-mysql

Once the installation is complete, you may start the MySQL service using the command:

sudo systemctl start mysql

Step 4 - Create a Passbolt Database

We need to create a new database for Passbolt. Login to MySQL using the following command:

sudo mysql -u root -p

Enter your MySQL root password when prompted.

Create a new database using the following query:

CREATE DATABASE passbolt_db;

Create a new database user and grant it full access to the database:

CREATE USER 'pbuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON passbolt_db.* TO 'pbuser'@'localhost';
FLUSH PRIVILEGES;

Step 5 - Install Passbolt

Download the Passbolt installation package from the official website. You can do this using wget:

sudo wget https://github.com/passbolt/passbolt_api/releases/download/2.13.5/passbolt-ce-2.13.5.tar.gz

Next, extract the contents of the package and move them to your web server's root directory:

sudo tar xfz passbolt-ce-2.13.5.tar.gz
sudo mv passbolt-ce /var/www/html/passbolt

Set the correct permissions on the Passbolt directory:

sudo chown -R www-data:www-data /var/www/html/passbolt

Step 6 - Configure Passbolt

Create a new configuration file by copying the sample provided:

sudo cp /var/www/html/passbolt/config/ .env /var/www/html/passbolt/config/.env

Edit the .env file and set the following environment variables:

# Database Configuration 
PASSBOLT_DATABASE_NAME=passbolt_db
PASSBOLT_DATABASE_USERNAME=pbuser
PASSBOLT_DATABASE_PASSWORD=password
 
# Application Configuration 
PASSBOLT_BASE_URL=http://localhost/passbolt
PASSBOLT_APP_FULL_BASE_URL=http://localhost/passbolt
PASSBOLT_SECRET_KEY=MY.VERY.UNIQUE.SECRET.KEY

Save the changes and exit the file.

Step 7 - Run the Passbolt Installer

Open your web browser and navigate to the following URL:

http://localhost/passbolt/index.php/install

Follow the on-screen instructions to complete the installation process.

Conclusion

In this tutorial, you have learned how to install Passbolt on Linux Mint. You may now use the newly installed password manager to securely store and share sensitive information with your team.

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!