How to Install Teampass on Ubuntu Server

In this guide, we will go through the step-by-step process of installing Teampass on Ubuntu Server.

Prerequisites

Before installing Teampass, ensure the following:

Step 1: Update System

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

Step 2: Install LAMP Stack

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

Step 3: Download and Extract Teampass

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/

Step 4: Create MySQL Database and User

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;

Step 5: Configure Teampass

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.

Step 6: Enable Apache Rewrite Module

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

Step 7: Access Teampass

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!

Conclusion

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!