mates-infra/docker-services/vaultwarden/README.md

Vaultwarden – self-hosted správce hesel

Kompatibilní s Bitwarden klienty. Open-source, lehký (Rust).

📋 Přehled

• Image: vaultwarden/server:latest
• Porty: 2999 (HTTP), 3012 (WebSocket, interní)
• User: 1000:1000
• Network: bridge

🚀 Instalace

cp .env.example .env
nano .env   # nastavit DOMAIN, ROCKET_PORT, hesla

docker compose up -d

🌐 Přístup

• Web vault: http://<server>:2999 (za HTTPS terminuj v NPM)
• Bitwarden app: stejná URL jako vault
• Doporučení: terminuj HTTPS přes NPM a nepoužívej HTTP přímo

🔐 Bezpečnost

• DOMAIN musí být https://vault.example.com (ne http)
• SIGNUPS_ALLOWED=false po registraci admin účtu
• INVITATIONS_ALLOWED=false pokud nechceš zvát další
• SHOW_PASSWORD_HINT=false (odhalování hesel)
• DATABASE_URL – zálohuj SQLite pravidelně

🔑 Záloha

# Zastavit kontejner
docker compose stop

# Zazálohovat SQLite DB
cp ./data/db.sqlite3 /backup/vaultwarden-$(date +%Y%m%d).sqlite3

# Restart
docker compose start

👥 Organizace

• 1 user (ty) – self-hosted
• 2FA – povinně aktivuj po registraci
• FIDO2/WebAuthn – podpora hardwarových klíčů (YubiKey)
• Organizace – pro sdílení hesel s rodinou

📁 Volumes

Mount	Účel
./data:/data	SQLite DB, attachmenty, ikony, config

📚 Klienti

• Mobil: Bitwarden (iOS/Android)
• Desktop: Bitwarden (Win/Mac/Linux)
• Browser: Bitwarden extension (Chrome/Firefox/Edge)
• CLI: rbw (Rust) nebo bitwarden-cli

🔄 Aktualizace

docker compose pull
docker compose up -d
# DB migrace probíhá automaticky

📚 Dokumentace

• Vaultwarden Wiki
• Bitwarden klienti