5 Kubernetes deployment

Didier Raboud edited this page 5 days ago

There are two options for deploying on Kubernetes:

• Natively
• Via Helm

Natively:

Please check the kubernetes-bitwarden_rs repository for example deployment in Kubernetes.

It will setup a fully functional and secure vaultwarden application in Kubernetes behind nginx-ingress-controller and AWS ELBv1. It provides a little bit more than just simple deployment but you can use all or just part of the manifests depending on your needs and setup.

Via Helm:

Please check the guerzon/vaultwarden repository for example deployment in Kubernetes.

Another option with as much, or even more, flexibility would be: https://github.com/gissilabs/charts/tree/master/vaultwarden

Table of Contents

• Natively:
• Via Helm:
• FAQs
• Troubleshooting
• Container Image Usage
• Reverse Proxy
• HTTPS
• Configuration
• Database
• Security
• Performance
• Customization
• Backup
• Development
• Alternative deployments
• Other Information
• 💬 Get in touch

FAQs

1. FAQs
2. Audits
3. Supporting upstream development

Troubleshooting

1. Logging
2. Bitwarden Android troubleshooting
3. Bitwarden clients troubleshooting

Container Image Usage

1. Which container image to use
2. Starting a container
3. Using Docker Compose
4. Using Podman
5. Updating the vaultwarden image

Reverse Proxy

1. Proxy examples
2. Using an alternate base dir (subdir/subpath)

HTTPS

1. Enabling HTTPS
2. Running a private vaultwarden instance with Let's Encrypt certs

Configuration

1. Overview
2. Enabling admin page
3. SMTP configuration
4. Disable registration of new users
5. Disable invitations
6. Enabling WebSocket notifications
7. Enabling Mobile Client push notification
8. Enabling SSO support using OpenId Connect
9. Other configuration

Database

1. Using the MariaDB (MySQL) Backend
2. Using the PostgreSQL Backend
3. Running without WAL enabled
4. Migrating from MariaDB (MySQL) to SQLite

Security

1. Hardening Guide
2. Password hint display
3. Enabling U2F and FIDO2 WebAuthn authentication
4. Enabling YubiKey OTP authentication
5. Fail2Ban Setup
6. Fail2Ban + ModSecurity + Traefik + Docker

Performance

1. Changing the API request size limit
2. Changing the number of workers

Customization

1. Translating the email templates
2. Translating admin page
3. Customize Vaultwarden CSS
4. Using custom website icons
5. Disabling or overriding the Vault interface hosting

Backup

1. General (not docker)
2. Backing up your vault

Development

1. Building binary
2. Building your own docker image
3. Git hooks
4. Differences from the upstream API implementation

Alternative deployments

1. Pre-built binaries
2. Creating a systemd service
3. Third-party packages
4. Deployment examples
5. Disable the admin token

Other Information

1. Importing data from Keepass or KeepassX
2. Changing persistent data location
3. Syncing users from LDAP
4. Caddy 2.x with Cloudflare DNS
5. Logrotate example

### 🛡️ Vaultwarden — A Bitwarden server, reimagined in Rust 🏠 Wiki Home · 📖 FAQs · ⚙️ Configuration · 🔒 Hardening Guide · 🐳 Docker

💬 Get in touch

---

❤️ Love Vaultwarden? Consider supporting upstream Bitwarden — without their work, this project wouldn't exist.

_{Vaultwarden is an unofficial, community-driven Bitwarden-compatible server. It is not associated with, endorsed by, or affiliated with Bitwarden, Inc. — "Bitwarden" is a trademark of Bitwarden, Inc.}

_{Maintained with care by @dani-garcia and contributors · Wiki content licensed under the project's terms}