In today's world, every organization and individual has to manage a lot of passwords and other credentials. It's not possible for anyone to remember all that confidential information.
So, in order to address this problem, there are many tools available most of them are paid while some are available as an Open Source.
Among all other tools, TeamPass is one of the best most useful open-source software to manage all your credentials within your Organization.
Teampass is a Collaborative Passwords Manager to organize the password items into structured way of folders.
It is associated with access rights given to dedicated users and groups. Teampass can be installed on Linux as well as on Windows.
Here at LinuxAPT, as part of our Server Management Services, we regularly help our Customers to perform Ubuntu related queries.
In this context, we shall look into how to install Teampass Passwords Manager on Ubuntu 20.04 LTS.
To begin, make your server accessible and up to date. Login with a user having sufficient rights to perform system tasks.
TeamPass is a web application that requires a web server and database server to support the application setup. So, our first step is to install and setup the LAMP stack that you can do by following our detailed article on LAMP stack setup.
Or use the commands below to install Apache, MariaDB, and PHP 7.4 on your system:
# apt-get install apache2 apache2-utils mariadb-server mariadb-client php7.4 libapache2-mod-php7.4 php7.4-mysql php-common php7.4-cli php7.4-common php7.4-json php7.4-opcache php7.4-readline php7.4-bcmath php7.4-curl php7.4-fpm php7.4-gd php7.4-xml php7.4-mbstring -y
Once the required packages are installed, make sure to start the services and enable them to auto-restart at the time of reboot.
# systemctl start apache2
# systemctl start mariadb
After installing the apache and database packages, let us run the command below to secure your database first.
# mysql_secure_installation
Reload privilege tables and create new database using the mysql root user using commands below.
# mysql -u root -p
> create database teampass;
> grant all privileges on teampass.* to teampass@localhost identified by "admin123";
> flush privileges;
> exit;
Here, you will see how to configure Apache for TeamPass.
Start by getting the installation package of teampass from its github repository and place that into the document root directory of our web server using the commands below:
# cd /var/www/html/
# git clone https://github.com/nilsteampassnet/TeamPass.git
After getting the teampass packages, set the ownership to www-data and update the permissions as 775 to its directory:
# chown -R www-data:www-data TeamPass/
# chmod -R 775 /var/www/html/TeamPass/
We also need to update the execution time limit of PHP in php.ini file using any editor.
# vim /etc/php/7.4/apache2/php.ini
max_execution_time = 60
Then run the command below to Save and quit the file:
:wq!
Here, we are ready to start the installation process of TeamPass by accessing the FQDN or IP of server followed by the teampass folder path as shown:
http://test.com/TeamPass
i. Once you get the welcome page, click Next to proceed with the Server checks option by applying the Launch button.
ii. When all the checkmarks are successful, click the next button.
iii. Next, we need to give the database connection details to see if it’s successful or not.
iv. After that choose the teampass table prefix, and give the teampass administrator account password of your choice.
v. This will take you to the Next page where it will populate the data into the database.
Now, we are at the finalization step to perform the following tasks:
a. Write the new setting.php file for your server configuration
b. Write the new sk.php file for data encryption
c. Change directory security permissions
vi. Next, the final step is the authentication to start using Teampass using the Administrator login as `admin` and the password that we have written during the installation process.
After the installation setup, we are ready to start using TeamPass.
Let's login with your admin credentials to its Administrator account.
Upon successful login attempt, you will get the administration web interface, where you will be able to create the new users, users roles, and folders.
i. Let's start creating a new folder from the top administration bar, give a name choose the parent folder, password strength, and access to roles.
ii. Next, you can create multiple roles as per your requirements, where you can assign specific folder rights to a particular role group of users.
iii. Now create a new user and assign it the newly created role.
So, these are the main key features available in teampass on the basis of what we do manage the administration side of TeamPass.
In order to manage and provide the desired rights, we can create multiple users roles and manage their access to specific folders.
TeamPass comes with two web interfaces, one to administer it and the other is its users end.
So, we are going to login using the newly created user.
Upon successful login let’s see how we can add and manage new credentials.
In order to store any new set of credentials, click to add a new item, put the relevant information and click on the Save button.
After making the saved change, you will get that listed below that folder.
This article covers perform the installation of TeamPass using the LAMP stack on Ubuntu. Now you can easily manage your credentials within your Organization to save credentials and manage access to every individual.
TeamPass is a Collaborative Passwords Manager used for managing passwords and sharing them among team members.
To Download Teampass on Ubuntu:
1. Start by cloning the Teampass repository to your web server root directory as shown below;
$ git clone https://github.com/nilsteampassnet/TeamPass.git /var/www/html/teampass
2. Set the ownership of the teampass web directory to web server user (www-data)
$ chown -R www-data.www-data /var/www/html/teampass/
3. Next, edit the /etc/php/7.2/apache2/php.ini configuration file and increase the script execution time from 30 to 60 secs.
vim /etc/php/7.2/apache2/php.ini
...
;max_execution_time = 30
max_execution_time = 60
...
4. Restart Apache web server
$ systemctl restart apache2
To Finalize TeamPass installation on Ubuntu:
Final installation of Teampass can be done from the browser.
Hence, navigate to the browser and enter the Teampass server URL,
http://Server_IP/teampass.
This will redirect you to Teampass welcome page