TeamPass

Contents

• About
• Who it's for
• Security
• Features
• Get started
• Documentation
• Languages
• Community
• Support Teampass
• License

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.

Items and secrets

Folders and roles

Authentication and MFA

Encryption keys

Search, export, one-time view

Background tasks

Who it's for

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.

• Security policy and how to report
• Published advisories
• ️ Security hardening guide

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

Features

• 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

• Encryption model — how keys are derived, wrapped and distributed
• Encryption improvements — the AES-256-GCM format and its lazy migration
• Key management — regeneration, recovery, per-user key repair

• Security Posture Dashboard scoring weak, reused and breached credentials
• Breach detection — 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

• Access reviews — recertification campaigns with immutable decisions
• Compliance reports — evidence you can hand to an auditor
• Rotation tracking — what was rotated, when, by whom
• Leaver risk — what a departing user could still know
• Data classification — ownership and sensitivity labels

• 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

• REST API — JWT-authenticated, OpenAPI 3.1 spec, Bash and PowerShell clients
• Browser extension — autofill, capture, one-click auto-configuration
• Background tasks — key distribution, notifications, maintenance
• Real-time collaboration — WebSocket sync and edition locks
• Backups — scheduled, encrypted database dumps

• 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

• Search — across labels, descriptions, tags and custom fields
• Command palette — keyboard-first navigation
• Favourites and quick access to recent items
• Custom fields — individually encryptable, role-restricted
• Knowledge base and notification center
• One-time view links and Secure Send for sharing outside the vault

Get started

Requirements

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.

• Official installation guide
• Upgrade guide
• File permissions
• Video tutorial

Documentation

Languages

Teampass ships in 25 languages, translated by the community.

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

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.

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).

Asking questions

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

Contributors

Teampass is what it is thanks to these people.

Star history

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 repor