What our customers say about Team Password Manager

How to install Team Password Manager

Current Team Password Manager version: 7.73.146

* Note: this document describes how to install Team Password Manager if your server has all the required components. Check the requirements document to learn more about them.

Here you have two alternative methods of installing Team Password Manager:

Short Version

1. Install the ionCube Loader.
2. Create the database in MySQL.
3. Upload the file to the server, decompress and place on web root.
4. Fill in the database parameters in config.php.
5. Execute the installer.
6. Register licenses (optional): click on the “Settings” option and the “Add a license”.
7. Place files outside of webroot (optional). See folder.php.
8. Make the 'import' folder writable by the web server.
9. Make the 'uploads' folder writable by the web server

Long Version

We assume you already have a working installation of Apache, PHP and MySQL. Follow these steps to install Team Password Manager:

1. Install the ionCube Loader

First, check to see if it’s already installed: create a php file on your server (ex: phpinfo.php) with the following command:

<?php phpinfo(); ?>

and open it with your browser. If the ionCube Loader is installed you should see the following line (usually in the third box before PHP credits):

“…with the ionCube PHP Loader vx.x.x …”

ioncube loader

If the ionCube Loader is not installed, install it:

Important: at the end of this step (or at the end of the install process), make sure you delete the phpinfo file. It is not needed for Team Password Manager to run and it's giving away information about your server.

2. Create the database in MySQL

You have to create the database that will store Team Password Manager data. Make sure the database user has enough privileges to create tables and insert/delete data.

You can use the following commands in the MySQL prompt or in phpMyAdmin:

CREATE DATABASE `tpm_database` CHARACTER SET utf8 COLLATE utf8_unicode_ci;
GRANT ALL PRIVILEGES ON `tpm_database`.* TO `tpm_user`@'localhost' IDENTIFIED BY 'tpm_password';

These commands create a database called tpm_database and a user called tpm_user with password tpm_password with all privileges on tpm_database.

3. Upload the file to the server

Decompress the Team Password Manager file (teampasswordmanager_x.x.x.zip) and upload the resulting files and folders to the server web root.

4. Fill in the configuration file

The configuration file config.php contains the database parameters that Team Password Manager uses:

- CONFIG_HOSTNAME: hostname of the machine where the database executes. Usually localhost.
- CONFIG_USERNAME: username to access the database server and the database created in step 2.
- CONFIG_PASSWORD: the password for the username. There needs to be a password, a blank one is not valid.
- CONFIG_DATABASE: the name of the database created in step 2.

5. Execute the installer

Point your browser to web_location_of_Team Password Manager_files/index.php/install and follow instructions. Example:


If everything is correct you have now a working Team Password Manager system. This is the Free Version, so you only have two users and a maximum of five projects. If you need more users and projects you should purchase one or more licenses and register them.

If you get the Internal Server Error 500 when executing the installer, see the document called Troubleshooting Internal Server Error 500.

6. Register licenses (optional)

Log into Team Password Manager with the user created on step 5 by the installer and click on “Settings” on the top menu. Go to the “Licenses” tab, click “Add a license” and fill in the license data sent to you by e-mail.

Team Password Manager add a license

7. Move the program files outside of webroot (optional)

For increased security you can place most of the files of Team Password Manager outside webroot, thus protecting them from direct Internet access.

The files that need to be “visible” are: index.php, folder.php, the css folder and the import folder. All the other files and folders can be located anywhere else on your system. This location is then entered in the APP_FOLDER parameter on the folder.php file. See folder.php for more instructions.

8. Make the 'import' folder writable by the web server

This folder is used by the import process. Give it 666 or 777 permissions so that Team Password Manager can write in it.

9. Make the 'uploads' folder writable by the web server

This folder is used to store files uploaded in passwords and projects. Give it 666 or 777 permissions so that Team Password Manager can write in it. You can also change its default location. Check config.php.

10. We advise you to delete the following files from your Team Password Manager folder: install.txt, eula.txt and upgrade.txt.

Questions or Problems? Please contact our support department