In this guide, we will go through the step-by-step process of installing Teampass on Ubuntu Server.
Before installing Teampass, ensure the following:
It is always a good practice to update the system before installing any new software. To do that, run the following command:
sudo apt-get update && sudo apt-get upgrade
Teampass requires a LAMP (Linux, Apache, MySQL, PHP) stack to be installed on the server. If you don't have it installed, you can do so by running the following command:
sudo apt-get install apache2 php mysql-server php-mysql libapache2-mod-php php-xml php-mbstring
Visit the official Teampass website and download the latest version. Alternatively, you can also download it directly from the command line by running:
wget https://teampass.net/files/Teampass_2.1.30.17.zip
Extract the Teampass zip file in the /var/www/html/ directory:
sudo unzip Teampass_2.1.30.17.zip -d /var/www/html/
Change the ownership of the Teampass directory:
sudo chown -R www-data:www-data /var/www/html/teampass/
Teampass requires a MySQL database and a user to access it. To create it, run the following commands:
sudo mysql -u root -p
You will be prompted to enter the root user password. After that, create a new database:
CREATE DATABASE teampassdb;
Then, create a new database user with the username and password of your choice:
CREATE USER 'teampassuser'@'localhost' IDENTIFIED BY 'password1';
Grant this user all privileges on the teampassdb database:
GRANT ALL PRIVILEGES ON teampassdb.* TO 'teampassuser'@'localhost' WITH GRANT OPTION;
Flush the privileges and exit the MySQL shell:
FLUSH PRIVILEGES;
exit;
Copy the configuration file:
sudo cp /var/www/html/teampass/includes/config/teampass.config.sample.php /var/www/html/teampass/includes/config/teampass.config.php
Open the Teampass configuration file:
sudo nano /var/www/html/teampass/includes/config/teampass.config.php
Change the database details to match the database created in Step 4:
define('PASSWORD_FILE', '/var/teampass/tp-passwords.txt');
define('DB_DRIVER', 'mysqli');
define('DB_HOST', 'localhost');
define('DB_PORT', 3306);
define('DB_NAME', 'teampassdb');
define('DB_USER', 'teampassuser');
define('DB_PASSWORD', 'password1');
Make sure to save the changes.
Teampass uses Apache's mod_rewrite module to display the correct URLs. To enable it, run the following command:
sudo a2enmod rewrite
Restart Apache:
sudo systemctl restart apache2
Open a web browser and go to http://your-server-ip/teampass/ to access Teampass.
Login with the default username and password: admin/admin.
Immediately change the admin password and start using Teampass!
In this tutorial, we have covered the step-by-step process of installing Teampass on Ubuntu Server. You can now start using it to manage your passwords in a secure and effective manner.
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!