Repository files navigation

Teampass is a Collaborative Passwords Manager solution installed On-Premise.

Copyright © 2009-2024,Nils Laumaillé

• Requirements
  • About PHP versions
• Documentation
  • Run from Docker image
  • Install with Docker
  • Install with Docker Compose
• Languages
• Licence Agreement
• Website
• Bugs

• MySQL 5.7 or higher,
• Mariadb 10.7 or higher
• PHP 8.1 or newer,
• PHP extensions:
  • mcrypt
  • openssl
  • ldap (if used)
  • mbstring
  • bcmath
  • iconv
  • xml
  • gd
  • mysql
  • curl
  • gmp

Website article with instructions:https://www.valters.eu/teampass-a-self-hosted-password-manager-to-increase-organizations-cybersecurity/

YouTube video:https://youtu.be/eXieWAIsGzc?feature=shared

Teampass should be installed using the most recent PHP version.The branchmaster is the living one that is improved and comes with new features.It requiresat leastPHP 8.1 installed on the server.

Nevertheless, Teampass can be used with PHP 7.4 version.The Github Teampass project has a dedicated branch calledPHP_7.4 for this version.Notice that only bug fixing will be performed on this branch.

✍️Documentation is available.

@valterseu created a Docker image from scratch with no dependencies and fully automated that you can also use.

Open theDocker Hub image and get all information.

Complete usage documentation can be found atGitHub Docker image URL.

The Docker image provided will create a Teampass installation in its/var/www/html/ directory, which you should mount as a volume to keep persistent.SSL is not provided if you use this image without a proxy in front of it. See the includedDocker Compose file for an example setup.

Note: Use/var/www/html/sk as your "Absolute path to saltkey" during installation.

The includeddocker-compose.yml file is an example setup, using virtual host-based reverse proxy routing to provide SSL. If you want to use the Compose file as-is, you will need to provide an SSL certificate with a CN matching theteampass service'sVIRTUAL_HOST variable. See the documentation for thejwilder/nginx-proxy image for details. In short, you'll need to put your certificate file (with extension .crt, e.g. teampass.domain.local.crt) and the according private key file (with extension .key, e.g. teampass.domain.local.key) into the directory ssl, named exactly after the FQDN you put into theVIRTUAL_HOST variable. Make sure to restart the nginx service after changes to the certificate or at least signal it with the reload command:docker-compose exec nginx nginx -s reload.

Note1: The database's hostname isdb. You can find the database's credentials in the environment variables of thedb service.

Note2: Use/var/www/html/sk as your "Absolute path to saltkey" during installation.

Teampass is currently available in the following languages:

• ENGLISH
• CATALAN
• CHINESE
• CZECH
• DUTCH
• ESTONIAN
• FRENCH
• GERMAN
• HUNGARIAN
• ITALIAN
• JAPANESE
• NORWEGIAN
• PORTUGUESE
• PORTUGUESE (BR)
• ROMANIAN
• RUSSIAN
• SPANISH
• TURKISH
• UKRAINIAN
• VIETNAMESE

Languages strings are managed atPOEditor.com.Please participate to improving its translation by joining Teampass POEditor project.

For detailed information on the licenses of our dependencies and our licence policy, please seeDetailed Licence Information.

VisitTeampass.net

If you discover bugs, please report them inGithub Issues.