How to Install Teampass on Debian Latest

Teampass is an open-source password management software that allows teams to manage passwords securely. It is a web-based application that can be installed on your local server or in cloud service.

This guide will show you how to install Teampass on Debian Latest.

Prerequisites

Before proceeding, you need to have the following in place:

  • Debian Latest Server
  • Apache or Nginx web server installed and configured
  • PHP 7.3 or later installed with the necessary extensions
  • MySQL 5.6 or later installed with a database created

Step 1: Download Teampass

First, you need to download the latest version of Teampass from their website. 

wget https://github.com/teampass/teampass/releases/download/v2.1.29/TeamPass_v2.1.29.zip

This will download the zip file containing Teampass to your system.

Next, extract the contents of the zip file to the document root of your web server.

sudo unzip TeamPass_v2.1.29.zip -d /var/www/html/

This will extract the Teampass files to the /var/www/html/ directory on your Debian Latest system.

Step 2: Configure Teampass

Before you can use Teampass, you need to configure it.

  1. Rename the file config/defaults.config.php to config/config.php.
sudo mv /var/www/html/config/defaults.config.php /var/www/html/config/config.php
  1. Edit the config.php file to configure the database and other settings.
sudo nano /var/www/html/config/config.php

a. Replace tp_login with your MySQL database username.

define("DB_LOGIN", "tp_login");

b. Replace tp_password with your MySQL database password.

define("DB_PASSWORD", "tp_password");

c. Replace tp_database with the name of the database you created for Teampass.

define("DB_DATABASE", "tp_database");

d. Uncomment define("DB_PREFIX", "tp_"); to add a prefix to your Teampass tables.

define("DB_PREFIX", "tp_");

e. Set your timezone.

define("TIMEZONE", "Europe/Paris");

f. Save and exit the file.

  1. Grant permissions to the config directory.
sudo chown -R www-data:www-data /var/www/html/config
sudo chmod -R 0770 /var/www/html/config

Step 3: Create a Virtual Host

If you have not already done so, you need to create a virtual host for Teampass.

  1. Create a new virtual host configuration file.
sudo nano /etc/apache2/sites-available/teampass.conf
  1. Add the following configuration.
<VirtualHost *:80>
   ServerName teampass.example.com
   DocumentRoot /var/www/html/
   <Directory /var/www/html/>
      Options FollowSymLinks
      AllowOverride All
      Order allow,deny
      allow from all
   </Directory>
   ErrorLog ${APACHE_LOG_DIR}/teampass_error.log
   CustomLog ${APACHE_LOG_DIR}/teampass_access.log combined
</VirtualHost>

  1. Save and exit the file.

  2. Enable the new virtual host.

sudo a2ensite teampass.conf
  1. Restart the Apache web server.
sudo systemctl restart apache2

Step 4: Access Teampass

You can now access Teampass through your web browser at the URL http://teampass.example.com.

Replace teampass.example.com with your server's hostname or IP address.

Step 5: Update Teampass

To update Teampass, download the latest version of Teampass from their website and replace the contents of the /var/www/html/ directory with the contents of the new version's zip file. 

sudo rm -rf /var/www/html/*
sudo unzip TeamPass_v2.x.x.zip -d /var/www/html/

Conclusion

Teampass is now installed on your Debian Latest server, and you can now manage your passwords securely with Teampass.