SERVING GREATER NEW ORLEANS

install TeamPass on Ubuntu 14.6LTS

Installing TeamPass on a fresh Ubuntu 14.6LTS server.

 

Find the latest version of TeamPass here https://github.com/nilsteampassnet/TeamPass/releases

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

wget https://github.com/nilsteampassnet/TeamPass/archive/2.1.26.14.tar.gz
sudo tar -xf 2.1.26.14.tar.gz -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-2.1.26.14/*  ./

 

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

teampass1

**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

teampass2

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

teampass3

 

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.

teampass4

 

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.

teampass5

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

teampass6

 

 

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.

teampass7

 

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

 

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

teampass9

 

 

Photo of 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.

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.

2 Comments

  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

    [mysqld]
    sql_mode = “STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION”

    (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 127.0.1.1 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 https://ubuntuforums.org/showthread.php?t=38429

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

    Thanks for this wonderful tutorial! 😀

Leave a Comment





Download Your FREE E-book Today

New Orleans IT Services Pricing Guide

Find out what managed IT services can do for you and why this is such an important step to take, by downloading your copy of our free eBook now.

Ebook download - blog sidebar