Skip to content

install TeamPass on Ubuntu 14.6LTS

Installing TeamPass on a fresh Ubuntu 14.6LTS server.


Find the latest version of TeamPass here

I’m using 2.1.26(14) which was the most recent version as of this writing.


Install Ubuntu 14.6, when asked what packages to install add LAMP (and SSH server if you want)

Then update Ubuntu and install some requirements:

sudo apt-get update and sudo apt-get upgrade
sudo apt-get install php-mysql php-mcrypt php-mbstring php-bcmath php-iconv php-xml php-gd openssl

download and unpack teampass

sudo tar -xf -C /var/www/html/

move files to root directory of web server (or another directory if you prefer)

cd /var/www/html
sudo mv TeamPass-*  ./


connect to install subdirectory with a browser http://<your server ip>/install/install.php


**if you see error message [ERROR] answer from server is empty, you probably need to enable mcrypt and restart apache

sudo php5enmod mcrypt
sudo service apache2 restart

Click Next and then click Launch


The install script checks a number of conditions and lets you know what needs to be configured or installed.



The page checks your server to make sure everything is ready to install. In this case there are some file permission errors.

Lets clear up those directory issues by changing the owner and permissions of the TeamPass files.

cd /var/www/html
sudo chown -R www-data:www-data *
sudo find * -type d -exec chmod 755 {} \;
sudo find * -dype f -exec chmod 644 {} \;

Edit php.ini (/etc/php/7.0/apache2/php.ini) to make the execution time larger, find the entry that reads max_execution_time = 30 and change to 60 then restart apache

Launch the install test again and verify that all the items have a green check.



Next; create the database and database user (you will need the root database credentials you created with installing the LAMP stack)

mysql -u root -p
create database TeamPass
grant all privileges on TeamPass.* to <username>@localhost identified by "password";

Once the database has been set up. You can click next on the install tool in the web browser and enter the details for the database user you just set up.


Then click Launch to test the database connection and move on to the Preparation section.

Generate SALT and table prefix, and set folder for salt file. (installer recomends /var/teampass/)

sudo mkdir /var/teampass
sudo chown www-data:www-data /var/teampass




Set up your mail settings here as well. (i dont have a SMTP server at the moment, so im skipping it right now).

Once the details have been entered, click launch to move to Table Creation. Here the installer creates the necessary database tables.



The installer then writes some settings and attempts to change some directory access settings.


And finally a finished message. You can now log into your TeamPass installation using the username “admin” and the password you created earlier.




Posted in

Dennis Bourn

For over two decades, Dennis Bourn and the team at Bourn Technology have been helping engineering firms, law practices and many other businesses across New Orleans and the surrounding areas get the most from the technology they value so much. To find out more information about what the right MSP can bring to the table, or to learn more about aligning your IT with your long-term goals as a business, please don't delay - contact Bourn Technology today.


  1. bob on August 16, 2016 at 9:51 am

    The default SQL mode in MySQL 5.7 includes mode: ONLY_FULL_GROUP_BY
    This is incompatible with Teampass, one will need to add a line to the MySQL config file to set the mode to old behavior:

    sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf


    (if you don’t know how to use vim editor, press ‘i’ to start editing, ‘esc’ to stop editing, then type :wq to write and quit)

    If the server is on the internet or you want to use https with real certificate, you will need to set the fully-qualified host name

    edit /etc/hostname and change the name

    edit /etc/hosts and move the line to the top, and change the server name to the full domain name.

    Teampass also could not send emails through my SMTP server requiring authorization. The solution was to install postfix to relay to smarthost, and configure it to rewrite from addresses like

  2. Someone on September 27, 2016 at 2:53 pm

    Thanks for this wonderful tutorial! 😀

Leave a Comment

Stay in the Know

Subscribe to our email newsletter today to receive updates on the latest news, cybersecurity tips and tricks and more. Enter your name and email address below to be the first to know.

Download Your FREE E-book Today

efficient business ebook cover

Not everything is black and white in business. Yet the importance of business efficiency is indisputable. To find out everything you need to know about the best choices for your business, download your copy of our free eBook - Efficient Businesses Run On Efficient I.T.

Ebook download - blog sidebar