TeamPass is a free, open source compliance & risk management project written in PHP and released under GPL-3.0. It has 1,869 GitHub stars, 571 forks and 4 open issues, and was last pushed 3 days ago. On this registry it ranks #35 of 56 tracked projects in Compliance & Risk Management, with 5 head-to-head comparisons available.

What is TeamPass?

TeamPass is a self-hosted, GPL-3.0 collaborative password manager written in PHP and backed by MySQL, aimed at individuals, teams and regulated organisations that need folder-level access control, per-user encryption keys and an audit trail while keeping every credential on infrastructure they control.

What it is

TeamPass is an open-source credential vault that a team runs itself. It is a PHP/MySQL application installed on the operator's own server, or run from the teampass/teampass Docker image, and it has been built and maintained since 2009. Secrets are encrypted with AES-256-GCM using random nonces and per-user encryption keys, and access to them is organised through folders and roles rather than through a shared document. Around that core sit LDAP/AD authentication with nested groups, OAuth2 single sign-on, multi-factor authentication, a REST API, a browser extension and an audit trail.

The concrete problem it addresses is credential sprawl inside an organisation: passwords living in chat threads and spreadsheets, with no record of who saw which secret and no way to demonstrate control to an auditor. TeamPass replaces that shared document with folders and roles, keeps a record of who accessed what and when, and provides compliance reports and evidence export so that access controls can be proven rather than merely claimed. It also offers a migration path through import from Bitwarden, LastPass, 1Password and KeePassXC, and it sits in the registry's Business Software / Compliance & Risk Management category.

Key capabilities

  • AES-256-GCM encryption of secrets with random nonces and per-user encryption keys, so a personal folder is encrypted with its owner's own key.
  • Folder-level access control backed by roles, defining which credentials each user is allowed to see.
  • Enterprise authentication through LDAP/AD with nested groups, OAuth2 SSO and multi-factor authentication.
  • An audit trail together with access recertification campaigns that record immutable decisions, plus compliance reports and evidence export.
  • A REST API and a browser extension for day-to-day autofill.
  • Secure Send for sharing credentials with clients and contractors, alongside one-time view, search and export of items.
  • Import from Bitwarden, LastPass, 1Password and KeePassXC, with a Docker image published as teampass/teampass.

Who uses it and how

  • Individuals and homelab operators run it on a Raspberry Pi or a €5 VPS, keep personal folders under their own encryption key, and pay nothing, with no sign-up required.
  • Teams and small businesses use folders and roles in place of a shared document, rely on the record of who accessed what and when, and issue Secure Send links to clients and contractors.
  • Enterprises and regulated organisations run access recertification campaigns, export compliance evidence, and connect the vault to LDAP/AD nested groups and OAuth2 SSO while classifying data by ownership.
  • Teams arriving from another manager import their existing vault from Bitwarden, LastPass, 1Password or KeePassXC and continue with the browser extension for autofill.

Getting started

Deploy the teampass/teampass image from Docker Hub, or install the PHP 8.2+ application against a MySQL database on a server you control; setup and configuration are documented at documentation.teampass.net.

How it compares

Bitwarden, LastPass, 1Password and KeePassXC appear in the facts only as import sources, so TeamPass is positioned as the place a team consolidates credentials it already holds rather than as a like-for-like hosted service. The contrast the facts do support is one of ownership: TeamPass is GPL-3.0 software running on the operator's own PHP/MySQL server, with no account to create and no company holding the data, whereas the named tools appear here as the sources from which vaults are imported.

When to use it — and when not to

A self-hoster must operate a PHP 8.2+ runtime, a MySQL database, the background tasks and the encryption keys themselves, on a server they patch and back up. Teams that want a hosted service with no server of their own, or that lack the capacity to run a LAMP-style stack, should look elsewhere. The facts show no hosted or managed option for TeamPass, so the deployment burden rests entirely with the adopter.

project readme (upstream, from github) — read inline

Teampass

Self-hosted password management your whole team can trust

Folder-level access control · authenticated AES-256-GCM encryption · compliance evidence
Your secrets never leave your infrastructure.

🌐 teampass.net · 📖 Documentation · 💬 Discussions · 🐳 Docker Hub


Release License PHP Docker Pulls Stars

CodeQL Docker Build Security policy Sponsor


Contents


About

Teampass is an open-source credential vault you run yourself. No account to create, no company behind the curtain holding your data — just a PHP/MySQL application on your own server, with folder-level access control, per-user encryption keys and a full audit trail.

It has been built and maintained since 2009, driven by what real teams actually run into: who should see which credential, how to prove it to an auditor, and how to stop passwords living in chat threads and spreadsheets.

Teampass interface
📸 More screenshots

Items and secrets

Folders and roles

Authentication and MFA

Encryption keys

Search, export, one-time view

Background tasks


Who it's for

🏠 Individuals & Homelab

Own your vault, literally.

  • Runs on a Raspberry Pi or a €5 VPS
  • Personal folders encrypted with your own key
  • Import from Bitwarden, LastPass, 1Password or KeePassXC
  • Free forever, no sign-up required

👥 Teams & SMB

Stop sharing passwords in chat.

  • Folders and roles instead of a shared document
  • A record of who accessed what, and when
  • Secure Send for clients and contractors
  • Browser extension for day-to-day autofill

🏛️ Enterprise & Regulated

Prove your access controls, don't just claim them.

  • Access recertification campaigns with immutable decisions
  • Compliance reports and evidence export
  • LDAP/AD with nested groups, OAuth2 SSO
  • Data classification and ownership

Security

Encryption you can describe to an auditor

Secrets are encrypted with AES-256-GCM using random nonces and per-secret salts, under 256-bit object keys. The private key that unlocks them is derived from your password with PBKDF2-SHA256 at 600 000 iterations.

  • Authenticated encryption — tampering is detected, not silently decrypted - Per-user key distribution — every user holds their own RSA-wrapped copy of each object key, so removing an account actually revokes access instead of just hiding a button
  • Lazy migration — format upgrades happen on access, with no maintenance window

Transparency over silence

A password manager that reports no vulnerabilities is not a password manager that has none.

Findings are triaged, fixed and published as GitHub Security Advisories with CVE identifiers.

Found a vulnerability? Please report it privately through GitHub Security Advisories — never in a public issue.


Features

🗂️ Folder and role access control
  • Folders — unlimited nesting, per-folder password complexity rules
  • Roles — grant access by role, not user by user
  • Rights — read, write, no-edit, no-delete, resolved least-permissive-wins
  • Users — per-user overrides on top of roles
  • Personal folders that nobody else can read, including administrators
🔐 Authenticated encryption
📊 Security posture
  • Security posture — a personal score for weak, reused and breached credentials, and Have I Been Pwned checks without sending your passwords
  • Password renewal — expiry policies and reminders
  • Micro-learning — in-app nudges instead of a yearly slideshow
🏛️ Governance and audit
🪪 Identity integration
  • Authentication — local, LDAP/AD with nested groups, OAuth2 / SSO
  • Multi-factor: TOTP (Google Authenticator), Duo Security, YubiKey, AGSES
  • Network ACL — restrict access by IP range
  • Session management — timeouts, concurrent sessions, Redis-backed storage
🤖 Automation
📦 Migration in and out
  • Import — Bitwarden, LastPass, 1Password, KeePassXC, CSV
  • Export — CSV, PDF, and a self-contained encrypted offline HTML vault
  • No lock-in: it is your database, on your server, under GPL-3.0
⚡ Daily productivity

Get started

Requirements

Database MySQL 5.7+ or MariaDB 10.7+
PHP 8.2 or newer (tested against 8.3)
Required extensions openssl mysqli mbstring bcmath iconv xml gd curl gmp — plus ldap for LDAP/AD
Recommended extensions apcu (config cache) · opcache (performance) · redis (HA sessions) · pcntl + posix (WebSocket daemon)

Teampass follows active PHP support. Running the latest stable PHP release is strongly recommended for both security and performance.

🐳 Docker

docker run -d --name teampass \
  -p 8080:80 \
  -v teampass_data:/var/www/html \
  teampass/teampass:latest

Images are published to both registries:

  • Docker Hub — teampass/teampass
  • GitHub Container Registry — ghcr.io/nilsteampassnet/teampass

📖 Docker guide · Migrating an existing install to Docker

🖥️ Bare metal (recommended for production)

Installing directly on a PHP/MySQL server gives the best performance and the most control over your environment.


Documentation

📖 Full documentation Install, features, administration
🚀 Installation Step-by-step first setup
🔄 Upgrade Moving between versions
🛡️ Security hardening Production checklist
⚙️ Performance PHP-FPM, caching, tuning
🔌 REST API Endpoints, JWT auth, clients
🧩 Browser extension Setup and usage
🩺 Troubleshooting When something goes wrong

Languages

Teampass ships in 25 languages, translated by the community.

English French German Spanish Italian
Portuguese Portuguese (BR) Dutch Russian Ukrainian
Polish Czech Hungarian Romanian Bulgarian
Greek Turkish Swedish Norwegian Estonian
Catalan Chinese Japanese Vietnamese 🇸🇦 Arabic (in progress)

Translations are managed on POEditor — a few strings from you go a long way.

Help translate


Community

Contributing

Contributions of any kind are very welcome. Fork the repo, make your changes, then open a pull request — see CONTRIBUTING.md for the development setup, coding standards and branch conventions, and CODE_OF_CONDUCT.md for how we work together.

Submit a PR

Reporting bugs

If something does not work as it should, raise a ticket. Please include the steps to reproduce, your server configuration, and the diagnostic report from Admin → Bug icon (bottom left).

Raise an Issue

Asking questions

Questions, deployment advice and ideas belong in Discussions rather than the issue tracker.

Discussions

Contributors

Teampass is what it is thanks to these people.

Contributors

Star history

Star History Chart


Support Teampass

Teampass is free, GPL-3.0, and has been maintained by one person since 2009. There is no company behind it — which is exactly the point, and also why support matters.

What sponsorship funds

  • Security work — triaging reports, fixing them, and publishing advisories with CVEs
  • Releases — testing, upgrade paths, and keeping older installations able to move forward
  • Documentation — the guides at documentation.teampass.net
  • Translations — coordinating 25 languages
  • Infrastructure — Docker images, CI, and the project websites

Become a sponsor

The goal is 100 monthly sponsors. Every tier helps, and small recurring amounts help most because they make the work predictable.

Sponsor on GitHub Donate via PayPal

Sponsors

Huge thanks to everyone who sponsors this work — you keep Teampass free for everyone else.

Sponsors

Commercial support

Sponsorship funds the free server. The browser extension and professional services fund the roadmap.

Pro Extension Browser autofill, capture and phishing protection — from €49/year, 30-day trial
Services Feature development, deployment assistance, priority handling — quoted per engagement

Pricing


License

Teampass is released under the GNU General Public License v3.0.

You are free to use, study, modify and redistribute it — including commercially — provided derivative works remain under the same license.

📋 Dependency license compliance report


Made in France

Built and maintained by Nils Laumaillé since 2009.

Copyright © 2009-2026 Nils Laumaillé


StandWithUkraine

Frequently asked questions

Is TeamPass free to use?

TeamPass is open source under the GPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does TeamPass do?

Self-hosted collaborative password manager for teams: folder-level access control, AES-256-GCM encryption, LDAP/AD, OAuth2 SSO, audit trail, REST API, browser e

What is TeamPass written in?

TeamPass is primarily written in PHP. Its source is publicly available at https://github.com/nilsteampassnet/TeamPass, and it has 1,869 GitHub stars.