Installing Teampass 2.1 on Ubuntu 10.10

Teampass is a great open source Collaborative Passwords Manager, it has been developed entirely by Nils Laumaillé based upon his original idea.

Official Website: http://www.teampass.net/

Installation:


Few prerequisites are needed first:

• PHP
• Apache
• MySQL
• PHP extension mcrypt

I chose Ubuntu 10.10 to install it on, other linux flavors can be used also.


First we need to update our package index, from the command line:
sudo apt-get update
Installing PHP:
sudo apt-get install php5
Installing MySQL (supply a MySQL root password when prompted):

sudo apt-get install mysql-server


Creating the MySQL Teampass database:
mysql -u root -p
>create database teampass;
>grant all privileges on teampass.* to root@'localhost' identified by 'yourmysqlrootpassword';
>exit


To download Teampass follow the instructions here: http://www.teampass.net/download/

Move the downloaded Zip file to /var/www
Unzip it:
unzip nilsteampassnet-TeamPass-*******.zip 
Rename it to teampass:
mv nilsteampassnet-TeamPass-******* teampass


Grant read/write access to some Teampass directories:


cd /var/www
chmod -R 777 teampass


Install PHP extension mcrypt:


sudo apt-get install php5-mcrypt


Restart the Apache server: service apache2 restart


From the Ubuntu web browser go to:


http://localhost/teampass


If everything is properly installed the Teampass installation page should open, scroll down, accept the license agreement and click next.


In the next page provide the absolute path: /var/www/teampass
and the full URL: http://localhost/teampass
and click launch, it should return Elements are OK.
Click next to fill the database information:
Host: localhost
Database name: teampass
Login: root
Password: the mysql root password
and click launch, it should return Connection is successful.


Click next to step 3, keep everything as is and click launch then next to the tables creation page.
On Step 4 click launch and it should return Database has been populated.
Click next for step 5 to create the setting.php file and next to finalize the installation.


Now from any PC's web browser you can go to http://yourserveripaddress/teampass and access the Teampass login page.




MySQL Notes:

• It is not a recommended practice to use the MySQL root user with the application installation, it is better to create a MySQL user just for the application and grant that user all the privileges on the teampass database.

• If you are installing from a remote machine, when you reach the installation step in which you connect to the database, it might not let you connect since MySQL prevents remote database connections by default, that's why i performed the installation from the server's browser. It is possible to allow remote database access to perform the installation from a remote machine, but i that would be an extra not needed hassle. After the installation in competed, access to the application is possible from any machine without any need to change anything.