You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Nicolas Massé
5828e563f8
|
2 weeks ago | |
|---|---|---|
| .. | ||
| config/examples | 3 weeks ago | |
| other | 4 weeks ago | |
| tmpfiles.d | 4 weeks ago | |
| Makefile | 3 weeks ago | |
| README.md | 2 weeks ago | |
| overlay.bu | 4 weeks ago | |
| vaultwarden.container | 4 weeks ago | |
| vaultwarden.target | 4 weeks ago | |
README.md
Podman Quadlet: Vaultwarden
Overview
Vaultwarden is a Bitwarden-compatible password manager server started as a Podman Quadlet. It provides a self-hosted alternative to the official Bitwarden server, compatible with all Bitwarden clients.
This cookbook:
- Runs Vaultwarden as a rootless container with minimal privileges.
- Uses PostgreSQL as the database backend (requires the
postgresqlcookbook). - Includes health checks to monitor the service status.
- Stores vault data in
/var/lib/virtiofs/data/vaultwarden/. - Supports automatic container image updates via Podman auto-update.
Prerequisites
- The
postgresqlcookbook must be installed and running. - Configuration file
/etc/quadlets/vaultwarden/config.envmust exist.
Usage
In a separate terminal, follow the logs.
sudo make tail-logs
Install the Podman Quadlets and start Vaultwarden.
sudo make clean install
You should see the vaultwarden.service waiting for PostgreSQL to be available, then starting up.
Verify Vaultwarden is running:
curl -sSf http://127.0.0.1:8080/
Access the web vault at http://127.0.0.1:8080/ and configure your Bitwarden clients to use this server.
Restart the vaultwarden.target unit.
sudo systemctl restart vaultwarden.target
Finally, remove the quadlets, their configuration and their data.
sudo make uninstall clean
Integration tests
sudo make test