Deployn

Vaultwarden selbst hosten: Docker-Anleitung mit Caddy und Fail2ban

Vaultwarden mit Docker Compose installieren: HTTPS über Caddy, Admin-Token mit Argon2, Registrierung sperren, Fail2ban gegen Brute Force und Backups der Datenbank.

Auf YouTube ansehen
Vaultwarden selbst hosten: Docker-Anleitung mit Caddy und Fail2ban hero image
Inhalt
Getestet mit
Vaultwarden 1.37.5Caddy 2.11Fail2ban 1.1.0Docker 29.9Docker Compose 5.7Debian 13
Zuletzt geprüft am

Mit Vaultwarden betreibst du deinen eigenen Passwort-Manager und nutzt trotzdem die gewohnten Bitwarden-Apps. In dieser Anleitung installiere ich Vaultwarden mit Docker Compose auf einem Debian 13 Server, hole das HTTPS-Zertifikat über Caddy, sperre die offene Registrierung und lasse Fail2ban Angreifer nach wenigen Fehlversuchen aussperren. Am Ende sicherst du die Datenbank mit einem einzigen Befehl.

Was ist Vaultwarden?

Vaultwarden ist ein Server für das Bitwarden-Ökosystem, geschrieben in Rust. Er spricht dieselbe Schnittstelle wie der offizielle Bitwarden-Server, deshalb funktionieren alle offiziellen Bitwarden-Clients: Browser-Erweiterungen, Desktop-Apps, die Apps für Android und iOS und die Kommandozeile. Früher hieß das Projekt bitwarden_rs. Der Quellcode liegt auf GitHub und steht unter der AGPL-3.0.

Unterschied zwischen Bitwarden und Vaultwarden

Bitwarden ist das Unternehmen hinter den Apps und dem offiziellen Server. Den Bitwarden-Server kannst du ebenfalls selbst hosten, er besteht aber aus mehreren Containern mit einer MSSQL- oder PostgreSQL-Datenbank und braucht deutlich mehr Arbeitsspeicher. Vaultwarden ist ein einzelner Container mit SQLite. Auf meinem Testserver belegte er im Leerlauf rund 11 MB RAM.

Vaultwarden ist kein offizielles Bitwarden-Produkt. Funktionen, die bei Bitwarden zum Premium-Abo gehören, zum Beispiel Dateianhänge und Notfallzugriff, sind bei Vaultwarden kostenlos. Das gilt auch für Organisationen mit beliebig vielen Mitgliedern, in denen du Passwörter mit Familie oder Team teilst. Probleme meldest du beim Vaultwarden-Projekt und nicht beim Bitwarden-Support.

Ist Vaultwarden sicher?

Die Verschlüsselung passiert in den Bitwarden-Clients. Der Server speichert nur verschlüsselte Tresore und kennt dein Master-Passwort nicht. Wer die Datenbank kopiert, kann damit ohne dein Master-Passwort nichts anfangen. Die Sicherheit deiner Instanz hängt deshalb vor allem an drei Dingen: ein starkes Master-Passwort mit Zwei-Faktor-Anmeldung, ein Server, den du aktuell hältst, und regelmäßige Backups. Um die beiden letzten Punkte geht es in dieser Anleitung.

Voraussetzungen

Ein Server mit DockerIch nutze einen VPS bei Hetzner (CX23 mit 2 vCPU und 4 GB RAM) mit Debian 13. Vaultwarden selbst kommt mit sehr wenig aus, ein Raspberry Pi oder der kleinste VPS reicht. Ein VPS bei netcup (Affiliate-Link) eignet sich genauso. Wie du Docker installierst, steht in den Docker-Grundlagen.
Ein Benutzer mit sudo-RechtenIch führe alle Docker-Befehle mit sudo aus. Den Benutzer in die Gruppe docker aufzunehmen, empfehle ich nicht: Das kommt Root-Rechten ohne Passwortabfrage gleich. Warum, steht in den Docker-Grundlagen.
Eine DomainZum Beispiel {{domain}}. Sie muss mit einem A-Record auf die IP-Adresse deines Servers zeigen. Die Bitwarden-Apps verbinden sich nur über HTTPS.
Offene Ports 80 und 443Caddy holt darüber das Zertifikat und nimmt die Anfragen entgegen.

Läuft dein Server zu Hause ohne öffentliche IPv4-Adresse, machst du ihn mit Pangolin erreichbar. Vaultwarden auf einem Synology NAS beschreibe ich in einer eigenen Anleitung.

Schritt 1: Domain und Docker prüfen

Verbinde dich per SSH mit deinem Server und prüfe, ob die Domain auf ihn zeigt:

Terminalbash
dig +short {{domain}}

Die Ausgabe muss die IP-Adresse deines Servers sein. Steht dort nichts oder eine andere Adresse, ist der DNS-Eintrag noch nicht angekommen. Warte dann, bevor du weitermachst, sonst schlägt das Zertifikat bei Let’s Encrypt fehl.

Danach prüfst du Docker:

Terminalbash
sudo docker --version
sudo docker compose version

Bei mir waren das Docker 29.9.3 und Docker Compose 5.7.1.

Schritt 2: Docker-Netzwerk und Caddy

Caddy und Vaultwarden liegen in eigenen Compose-Projekten und finden sich über ein gemeinsames Docker-Netzwerk. Ich nenne es proxy:

Terminalbash
sudo docker network create proxy

Läuft Caddy bei dir schon so wie in meiner Caddy-Anleitung, überspringst du den Rest dieses Schritts. Sonst legst du Caddy jetzt an:

Terminalbash
mkdir -p ~/caddy/data ~/caddy/config
cd ~/caddy
nano compose.yaml
~/caddy/compose.yamlyaml
services:
  caddy:
    image: caddy:2.11
    container_name: caddy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./data:/data
      - ./config:/config
    networks:
      - proxy

networks:
  proxy:
    external: true

Die Caddyfile bekommt einen Block für Vaultwarden:

Terminalbash
nano ~/caddy/Caddyfile
~/caddy/Caddyfilecaddy
{{domain}} {
	reverse_proxy vaultwarden:80 {
		header_up X-Real-IP {remote_host}
	}
}
  • vaultwarden:80 ist der Name des Containers und der Port, auf dem Vaultwarden im Container lauscht.
  • header_up X-Real-IP {remote_host} gibt die echte IP-Adresse des Besuchers weiter. Vaultwarden liest diesen Header. Ohne die Zeile stand in meinem Log bei jedem Fehlversuch IP: 172.18.0.3, also die Adresse des Caddy-Containers. Fail2ban hätte dann Caddy gesperrt und damit alle Besucher.

Gestartet wird Caddy erst im nächsten Schritt zusammen mit Vaultwarden.

Schritt 3: Vaultwarden mit Docker Compose

Lege ein Verzeichnis für Vaultwarden an:

Terminalbash
mkdir -p ~/vaultwarden/vw-data
cd ~/vaultwarden
nano compose.yaml
~/vaultwarden/compose.yamlyaml
services:
  vaultwarden:
    image: vaultwarden/server:1.37.5
    container_name: vaultwarden
    restart: unless-stopped
    user: "1000:1000"
    environment:
      DOMAIN: "https://{{domain}}"
      TZ: "Europe/Berlin"
    volumes:
      - ./vw-data:/data
    networks:
      - proxy

networks:
  proxy:
    external: true
  • image: Ich nenne die Version ausdrücklich. Mit latest kommt ein Update unbemerkt beim nächsten pull, und bei einem Passwort-Manager will ich vorher ein Backup haben. Die aktuelle Version steht in den Releases auf GitHub.
  • user: Vaultwarden läuft damit nicht als root, sondern mit deiner Benutzer-ID. Die findest du mit id -u und id -g. Der erste Benutzer auf Debian und Ubuntu hat meistens 1000.
  • DOMAIN: Die vollständige Adresse mit https://. Vaultwarden braucht sie für Links in E-Mails, für Dateianhänge und für Sicherheitsschlüssel (WebAuthn).
  • TZ: Die Zeitzone für die Zeitstempel im Log. Eigene Mounts für /etc/localtime und /etc/timezone brauchst du dafür nicht. Im Test zeigte sudo docker exec vaultwarden date mit TZ allein die richtige Zeit.
  • Keine ports: Vaultwarden ist nur über Caddy erreichbar. Von außen gibt es keinen Weg am HTTPS vorbei.

Ein version:-Feld steht nicht mehr in der Datei. Docker Compose ignoriert es und gibt nur eine Warnung aus. Auch WEBSOCKET_ENABLED brauchst du nicht mehr: Seit Version 1.29 laufen die Live-Benachrichtigungen über den normalen Port 80.

Der Ordner vw-data muss deinem Benutzer gehören, sonst kann Vaultwarden die Datenbank nicht anlegen:

Terminalbash
sudo chown -R 1000:1000 ~/vaultwarden/vw-data

Jetzt startest du Vaultwarden und danach Caddy:

Terminalbash
cd ~/vaultwarden
sudo docker compose up -d
cd ~/caddy
sudo docker compose up -d

Nach etwa 20 Sekunden zeigt sudo docker ps beide Container als Up. Im Ordner vw-data liegen jetzt die Datenbank db.sqlite3 und der Schlüssel rsa_key.pem.

Schritt 4: Konto anlegen

Öffne https://{{domain}} im Browser. Du siehst die Weboberfläche von Vaultwarden, den sogenannten Web-Tresor. Klicke auf „Konto erstellen“, gib deine E-Mail-Adresse ein und vergib ein Master-Passwort.

Das Master-Passwort ist der Schlüssel zu deinem Tresor. Vergisst du es, kann niemand deine Daten wiederherstellen, auch du als Admin nicht. Schreibe es auf Papier und lege es an einen sicheren Ort.

In den Bitwarden-Apps wählst du bei der Anmeldung als Server „Selbst gehostet“ und trägst https://{{domain}} als Server-URL ein.

Schritt 5: Registrierung sperren und Admin-Bereich einrichten

Bis jetzt kann jeder, der deine Adresse kennt, ein Konto anlegen. Das schaltest du ab. Gleichzeitig richtest du den Admin-Bereich unter https://{{domain}}/admin ein. Dort verwaltest du Benutzer, lädst Leute ein und stellst den E-Mail-Versand ein.

Admin-Token erzeugen

Der Admin-Bereich ist mit einem Token geschützt. Vaultwarden bringt einen Befehl mit, der dein Admin-Passwort mit Argon2 hasht. Ein extra Paket brauchst du nicht:

Terminalbash
sudo docker exec -it vaultwarden /vaultwarden hash

Der Befehl fragt zweimal nach dem Passwort und gibt dann eine Zeile aus:

ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$KtZIn7Gr7tysnCZT61E+uAgm0YtVcKJruHeKLDoxFrs$IOTelZ9PeeUK2hzAd+3B3rWoeY7tw+YqamWs6XPnWL8'

Das -it ist nötig, weil der Befehl ein Terminal für die Passworteingabe braucht. Ohne bricht er mit No such device or address ab.

Kopiere die ganze Zeile in eine Datei .env neben der compose.yaml:

Terminalbash
nano ~/vaultwarden/.env
chmod 600 ~/vaultwarden/.env

In der .env stehen die einfachen Anführungszeichen schon richtig. Dadurch nimmt Docker Compose die $-Zeichen wörtlich. Schreibst du den Hash direkt in die compose.yaml, musst du jedes $ als $$ schreiben, sonst versucht Compose, Variablen daraus zu machen.

Compose-Datei ergänzen

Öffne die compose.yaml und ergänze env_file, SIGNUPS_ALLOWED und die beiden Log-Variablen:

~/vaultwarden/compose.yamlyaml
services:
  vaultwarden:
    image: vaultwarden/server:1.37.5
    container_name: vaultwarden
    restart: unless-stopped
    user: "1000:1000"
    env_file: .env
    environment:
      DOMAIN: "https://{{domain}}"
      TZ: "Europe/Berlin"
      SIGNUPS_ALLOWED: "false"
      LOG_FILE: "/data/vaultwarden.log"
      LOG_LEVEL: "warn"
    volumes:
      - ./vw-data:/data
    networks:
      - proxy

networks:
  proxy:
    external: true
  • SIGNUPS_ALLOWED: "false": Niemand kann sich mehr selbst registrieren. Neue Benutzer lädst du im Admin-Bereich ein.
  • LOG_FILE und LOG_LEVEL: Vaultwarden schreibt Warnungen und Fehler zusätzlich in vw-data/vaultwarden.log. Fehlgeschlagene Anmeldungen landen dort als ERROR. Diese Datei liest später Fail2ban.

Dann den Container neu erstellen:

Terminalbash
cd ~/vaultwarden
sudo docker compose up -d

Melde dich unter https://{{domain}}/admin mit deinem Klartext-Passwort an, nicht mit dem Hash. Versuchst du jetzt, ein neues Konto anzulegen, antwortet Vaultwarden mit „Registration not allowed or user already exists“.

Im Admin-Bereich unter „SMTP Email Settings“ trägst du einen Mailserver ein. Dann verschickt Vaultwarden Einladungen, Hinweise auf neue Anmeldungen und Codes für die Zwei-Faktor-Anmeldung per E-Mail.

Schritt 6: Zwei-Faktor-Anmeldung einschalten

Im Web-Tresor findest du unter „Einstellungen“ → „Sicherheit“ → „Zwei-Faktor-Authentifizierung“ die Verfahren, die Vaultwarden kennt: Authenticator-App (TOTP), Sicherheitsschlüssel per FIDO2/WebAuthn, YubiKey OTP, Duo und E-Mail. Eine Authenticator-App wie Aegis oder 2FAS ist der einfachste Einstieg.

Stärker ist ein Hardware-Schlüssel, zum Beispiel ein YubiKey 5 NFC (Amazon Affiliate-Link). Er funktioniert per USB am Rechner und per NFC am Handy. Richte zwei Schlüssel ein und lege den zweiten getrennt ab, damit du bei Verlust nicht ausgesperrt bist. Den Wiederherstellungscode, den Vaultwarden dir beim Einrichten zeigt, bewahrst du zusammen mit dem Master-Passwort auf.

Schritt 7: Fail2ban gegen Brute-Force-Angriffe

Fail2ban liest das Log von Vaultwarden, zählt Fehlversuche pro IP-Adresse und sperrt Angreifer für eine Zeit in der Firewall. Ich installiere Fail2ban direkt auf dem Server, nicht im Container:

Terminalbash
sudo apt install -y fail2ban

Filter

Der Filter beschreibt, welche Zeilen ein Fehlversuch sind. So sieht eine falsche Anmeldung im Log aus:

[2026-11-15 16:17:55.260][vaultwarden::api::identity][ERROR] Username or password is incorrect. Try again. IP: 203.0.113.7. Username: nobody@example.com.

Lege den Filter für die normale Anmeldung an:

Terminalbash
sudo nano /etc/fail2ban/filter.d/vaultwarden.local
/etc/fail2ban/filter.d/vaultwarden.localini
[INCLUDES]
before = common.conf

[Definition]
failregex = ^.*?Username or password is incorrect\. Try again\. IP: <ADDR>\. Username:.*$
ignoreregex =

Und einen zweiten für den Admin-Bereich. Dort lautet die Zeile Invalid admin token. IP: 203.0.113.7:

Terminalbash
sudo nano /etc/fail2ban/filter.d/vaultwarden-admin.local
/etc/fail2ban/filter.d/vaultwarden-admin.localini
[INCLUDES]
before = common.conf

[Definition]
failregex = ^.*?Invalid admin token\. IP: <ADDR>.*$
ignoreregex =

Jail

Der Jail verbindet Filter, Logdatei und Sperrdauer:

Terminalbash
sudo nano /etc/fail2ban/jail.d/vaultwarden.local
/etc/fail2ban/jail.d/vaultwarden.localini
[vaultwarden]
enabled = true
backend = auto
port = http,https
filter = vaultwarden
logpath = /home/{{username}}/vaultwarden/vw-data/vaultwarden.log
maxretry = 5
findtime = 1h
bantime = 24h
banaction = iptables-multiport
chain = DOCKER-USER

[vaultwarden-admin]
enabled = true
backend = auto
port = http,https
filter = vaultwarden-admin
logpath = /home/{{username}}/vaultwarden/vw-data/vaultwarden.log
maxretry = 3
findtime = 10h
bantime = 7d
banaction = iptables-multiport
chain = DOCKER-USER
  • maxretry, findtime, bantime: Wer innerhalb einer Stunde fünfmal ein falsches Passwort eingibt, ist 24 Stunden gesperrt. Für den Admin-Bereich gelten drei Versuche in zehn Stunden und sieben Tage Sperre.
  • backend = auto: Debian 13 liest den SSH-Jail aus dem systemd-Journal. Vaultwarden schreibt aber in eine Datei. Die Zeile stellt sicher, dass Fail2ban für diese Jails die Datei aus logpath liest.
  • chain = DOCKER-USER: Anfragen an Docker-Container laufen an der normalen Kette INPUT vorbei. Eine Sperre dort würde bei Caddy nichts bewirken. Die Kette DOCKER-USER prüft Docker vor seinen eigenen Regeln, dort greift die Sperre.
  • logpath: Der Pfad auf dem Server, nicht im Container. Ersetze {{username}} durch deinen Benutzernamen.

Bevor du Fail2ban neu startest, prüfst du den Filter gegen das echte Log. Dazu brauchst du mindestens einen Fehlversuch, also melde dich einmal mit einem falschen Passwort an:

Terminalbash
sudo fail2ban-regex /home/{{username}}/vaultwarden/vw-data/vaultwarden.log /etc/fail2ban/filter.d/vaultwarden.local

In der Ausgabe muss bei Failregex mindestens ein Treffer stehen. Dann startest du Fail2ban neu:

Terminalbash
sudo systemctl restart fail2ban
sudo fail2ban-client status
Status
|- Number of jail:	3
`- Jail list:	sshd, vaultwarden, vaultwarden-admin

Sperre testen

Gib im Web-Tresor fünfmal ein falsches Passwort ein. Danach lädt die Seite nicht mehr. Bei mir lief die nächste Anfrage ins Leere, und der Status zeigte meine Adresse:

Terminalbash
sudo fail2ban-client status vaultwarden
Status for the jail: vaultwarden
|- Filter
|  |- Currently failed:	0
|  |- Total failed:	5
|  `- File list:	/home/deployn/vaultwarden/vw-data/vaultwarden.log
`- Actions
   |- Currently banned:	1
   |- Total banned:	1
   `- Banned IP list:	203.0.113.7

Die Sperre hebst du so wieder auf:

Terminalbash
sudo fail2ban-client set vaultwarden unbanip DEINE-IP

Schritt 8: Backup

Für ein vollständiges Backup brauchst du den ganzen Ordner ~/vaultwarden/vw-data:

  • db.sqlite3: Die Datenbank mit allen verschlüsselten Tresoren.
  • rsa_key.pem: Der Schlüssel, mit dem Vaultwarden Anmeldungen signiert. Ohne ihn müssen sich alle Clients nach einer Wiederherstellung neu anmelden.
  • attachments und sends: Dateianhänge und Dateien aus Bitwarden Send, sobald es welche gibt.
  • config.json: Die Einstellungen aus dem Admin-Bereich, falls du dort etwas gespeichert hast.

Dazu kommen compose.yaml und .env. Die .env enthält den Hash deines Admin-Passworts, behandle das Backup entsprechend.

Eine SQLite-Datei, in die gerade geschrieben wird, solltest du nicht einfach kopieren. Vaultwarden erstellt dir eine saubere Kopie im laufenden Betrieb:

Terminalbash
cd ~/vaultwarden
sudo docker compose exec vaultwarden /vaultwarden backup
Backup to 'data/db_20261115_151902.sqlite3' was successful

Die Kopie liegt in vw-data und geht mit dem Ordner in dein Backup. Damit das jede Nacht passiert, trägst du mit sudo crontab -e zwei Zeilen in die Crontab von root ein. Die erste legt um 3 Uhr eine Kopie an, die zweite löscht Kopien, die älter als 14 Tage sind:

Terminalbash
0 3 * * * docker compose -f /home/{{username}}/vaultwarden/compose.yaml exec -T vaultwarden /vaultwarden backup
15 3 * * * find /home/{{username}}/vaultwarden/vw-data -name 'db_*.sqlite3' -mtime +14 -delete

-T ist wichtig, weil Cron kein Terminal hat. Den Ordner bringst du danach mit einem Backup-Programm wie Duplicati auf ein anderes Gerät. Ein Backup auf demselben Server hilft dir nicht, wenn der Server ausfällt.

Vaultwarden aktualisieren

Neue Versionen beheben oft Sicherheitslücken. Abonniere die Releases auf GitHub, dann bekommst du eine Nachricht. So aktualisierst du:

  1. Lies die Release Notes der neuen Version.
  2. Erstelle ein Backup mit sudo docker compose exec vaultwarden /vaultwarden backup.
  3. Ändere den Tag in der compose.yaml, zum Beispiel von 1.37.5 auf die neue Version.
  4. Lade das Image und erstelle den Container neu:
Terminalbash
cd ~/vaultwarden
sudo docker compose pull
sudo docker compose up -d

Mit sudo docker compose logs vaultwarden siehst du, ob der Start geklappt hat. Die Datenbank passt Vaultwarden beim Start selbst an.

Häufige Fragen

Ist Vaultwarden kostenlos?

Ja. Vaultwarden ist Open Source unter der AGPL-3.0. Auch Funktionen aus dem Premium-Abo von Bitwarden, wie Dateianhänge und Notfallzugriff, sind enthalten. Du zahlst nur für Server und Domain.

Wie viele Ressourcen braucht Vaultwarden?

Sehr wenige. Auf meinem Testserver belegte Vaultwarden im Leerlauf rund 11 MB Arbeitsspeicher, Caddy rund 17 MB. Ein Raspberry Pi oder der kleinste VPS reicht.

Kann ich die offiziellen Bitwarden-Apps nutzen?

Ja. Wähle bei der Anmeldung in der App oder Browser-Erweiterung als Server "Selbst gehostet" und trage deine Adresse mit https:// ein.

Kann ich Vaultwarden ohne Domain nutzen?

Nur eingeschränkt. Die Bitwarden-Clients und der Web-Tresor brauchen HTTPS mit einem gültigen Zertifikat. Ohne öffentliche Domain kannst du Caddy mit einem internen Zertifikat betreiben, musst es dann aber auf jedem Gerät als vertrauenswürdig eintragen.

Was passiert, wenn mein Server ausfällt?

Die Bitwarden-Apps speichern eine verschlüsselte Kopie deines Tresors auf dem Gerät. Du kannst Passwörter weiter lesen, aber nichts ändern, bis der Server wieder läuft. Deshalb ist ein Backup auf einem anderen Gerät wichtig.

Als Amazon-Partner verdiene ich an qualifizierten Verkäufen.

Teilen
XRedditE-Mail
Zurück zu allen Beiträgen

Änderungsprotokoll

  1. Auf Vaultwarden 1.37.5 aktualisiert: Compose ohne version-Feld, DOMAIN gesetzt, Admin-Token mit dem eingebauten Befehl vaultwarden hash in einer .env-Datei, Registrierung per SIGNUPS_ALLOWED gesperrt, Fail2ban auf dem Host mit DOCKER-USER-Kette, Backup mit vaultwarden backup, Abschnitte zu Zwei-Faktor-Anmeldung, Updates und FAQ ergänzt.

Verwandte Artikel

Kommentare