TeamVault
TeamVault is an open-source web-based shared password manager for behind-the-firewall installation. It requires Python 3.10+ and PostgreSQL (with the unaccent extension).
Installation
apt-get install libffi-dev libldap2-dev libpq-dev libsasl2-dev python3.X-dev postgresql-contrib
pip install teamvault
teamvault setup
vim /etc/teamvault.conf
# note that the teamvault database user will need SUPERUSER privileges
# during this step in order to activate the unaccent extension
teamvault upgrade
teamvault plumbing createsuperuser
teamvault run
Update
pip install --upgrade teamvault
teamvault upgrade
Development
Start a PostgreSQL database
Create a database and superuser for TeamVault to use, for example by starting a Docker container:
docker run --rm --detach --publish=5432:5432 --name teamvault-postgres -e POSTGRES_USER=teamvault -e POSTGRES_PASSWORD=teamvault postgres:latest
Run Webpack to serve static files
To compile all JS & SCSS files, you'll need to install all required packages via bun (or yarn/npm) with node >= v18.
Use bun/yarn/npm run serve to start a dev server.
Note: Some MacOS users have reported errors when running the dev server via bun. In this case feel free to switch to NPM.
Configure your Virtualenv via uv
uv sync
Setup TeamVault
export TEAMVAULT_CONFIG_FILE=teamvault.cfg
teamvault setup
vim teamvault.cfg # base_url = http://localhost:8000
# session_cookie_secure = False
# database config as needed
teamvault upgrade
teamvault plumbing createsuperuser
Start the development server
teamvault run
Now open http://localhost:8000
Scheduled background jobs
We use huey to run background jobs. This requires you to run a second process, in parallel to TeamVault itself. You can launch it via manage.py:
teamvault run_huey
Release process
- Bump the version in
teamvault/__version__.pyandpyproject.toml - Update CHANGELOG.md with the new version and current date
- Make a release commit with the changes made above
- Push the commit
- Run
./build.shto create a new package - Sign and push the artifacts to PyPI via
uv publish - Test that the package can be installed:
uv run --isolated --no-cache --prerelease allow --with teamvault --no-project -- teamvault --version - Add a new GitHub release
5 maintainers
Metadata
5 maintainers
Release files for teamvault 0.11.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| teamvault-0.11.3.tar.gz | 5.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| teamvault-0.11.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.7 MB
Release files / teamvault-0.11.3.tar.gz
| Download URL | teamvault-0.11.3.tar.gz |
|---|---|
| Size | 5.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4e34e75dfe30ee29ea3696b98874dd6f1fdfed84de2f5fb7516d634c46764273
|
|
BLAKE2b-256 checksum How to use checksums |
7e24a5fa76d0e9e544f20f5086f37e4afa8f1d7e79ba2cc00da7ec62078986a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.16 {"installer":{"name":"uv","version":"0.9.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / teamvault-0.11.3-py3-none-any.whl
| Download URL | teamvault-0.11.3-py3-none-any.whl |
|---|---|
| Size | 5.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
16c1cb82380160ada7d64bb062aa0229bde9833856078845635d6d223ac1c9e3
|
|
BLAKE2b-256 checksum How to use checksums |
8add3ee9f85d6de24ea8ae56d87ad6ce5d87ed12824cd2bf525814e51e59f33c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.16 {"installer":{"name":"uv","version":"0.9.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
