Installer Vaultwarden avec HTTPS et sauvegardes
Hébergez Vaultwarden sur Debian ou Ubuntu avec Docker et Caddy : HTTPS obligatoire, inscriptions fermées, jeton d'administration haché, mises à jour, sauvegarde et test de restauration.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Ce guide vous explique comment héberger Vaultwarden, un serveur léger compatible avec les applications Bitwarden, sur votre propre serveur. Vaultwarden tourne dans Docker et reste accessible uniquement en local. Caddy le publie en HTTPS.
À la fin du guide, votre coffre répond sur https://vault.votre-domaine.com, personne ne peut s’y inscrire sans invitation, le jeton d’administration est stocké sous forme hachée et une sauvegarde quotidienne existe, dont vous avez vérifié la restauration.
Commander un serveur
Ce guide s’applique aux serveurs que vous administrez vous-même :
Prérequis
- Un serveur sous Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04
- Un accès SSH avec un utilisateur disposant de
sudo - Docker Engine et Docker Compose, installés avec le guide Installer Docker Engine et Docker Compose
- Caddy, installé avec le guide Caddy en reverse proxy avec HTTPS automatique
- Un nom de domaine dont vous gérez la zone DNS
- L’adresse IP publique de votre poste, pour restreindre la page d’administration
Ports utilisés
| Port | Sens | Rôle | À ouvrir |
|---|---|---|---|
| 80/tcp | Entrant | Validation du certificat et redirection vers HTTPS | Oui |
| 443/tcp | Entrant | Accès HTTPS au coffre | Oui |
| 443/udp | Entrant | HTTP/3 | Recommandé |
| 8222/tcp | Local | Vaultwarden, sur 127.0.0.1 uniquement |
Non |
Étape 1 : préparer le domaine et le pare-feu
Créez un enregistrement A pour vault.votre-domaine.com vers VOTRE_IP_SERVEUR. Si votre domaine est géré chez HostMyServers, suivez le guide Créer un enregistrement A.
Si vous utilisez UFW, autorisez les ports web :
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp
sudo ufw statusSi UFW n’est pas encore actif, suivez d’abord le guide Configurer le pare-feu UFW sans perdre l’accès SSH.
Les ports publiés par Docker contournent les règles UFW. C’est pourquoi le fichier Compose de l’étape 3 publie Vaultwarden sur 127.0.0.1 : il n’est alors pas joignable depuis Internet, quelles que soient vos règles.
Étape 2 : créer le jeton d’administration haché
La page /admin permet de gérer les comptes de l’instance. Elle est protégée par un jeton, que vous allez conserver uniquement sous forme d’empreinte Argon2.
Créez le dossier de l’application, puis générez un mot de passe d’administration long et aléatoire :
sudo mkdir -p /opt/vaultwarden
cd /opt/vaultwarden
openssl rand -base64 32Conservez ce mot de passe hors du coffre, par exemple dans un autre gestionnaire ou sur un support hors ligne. Vous en aurez besoin pour vous connecter à /admin, y compris si le coffre est indisponible.
Calculez ensuite son empreinte. La commande demande le mot de passe deux fois :
sudo docker run --rm -it vaultwarden/server:1.37.5 /vaultwarden hashElle affiche une ligne de cette forme :
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$...'Créez le fichier .env :
sudo nano /opt/vaultwarden/.envCollez-y l’empreinte, entre apostrophes et sans doubler les $ :
VAULTWARDEN_ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$...'Protégez le fichier :
sudo chmod 600 /opt/vaultwarden/.envÉtape 3 : écrire le fichier Compose
sudo nano /opt/vaultwarden/compose.yamlservices:
vaultwarden:
image: vaultwarden/server:1.37.5
container_name: vaultwarden
restart: unless-stopped
environment:
DOMAIN: "https://vault.votre-domaine.com"
SIGNUPS_ALLOWED: "false"
ADMIN_TOKEN: "${VAULTWARDEN_ADMIN_TOKEN}"
volumes:
- ./vw-data:/data
ports:
- "127.0.0.1:8222:80"| Paramètre | Rôle |
|---|---|
image |
Version précise, que vous changez volontairement lors des mises à jour |
DOMAIN |
Adresse publique exacte, avec https:// |
SIGNUPS_ALLOWED |
false ferme les inscriptions libres dès le premier démarrage |
ADMIN_TOKEN |
Empreinte lue dans .env |
127.0.0.1:8222:80 |
Port accessible uniquement depuis le serveur |
Contrôlez le résultat, puis démarrez le service :
cd /opt/vaultwarden
sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps
curl -fsS http://127.0.0.1:8222/aliveLa dernière commande renvoie une date entre guillemets. Après environ une minute, la colonne d’état de docker compose ps indique healthy.
Étape 4 : publier le coffre avec Caddy
Ajoutez ce site dans /etc/caddy/Caddyfile, ou dans un fichier de /etc/caddy/sites/ si vous utilisez des imports :
vault.votre-domaine.com {
encode zstd gzip
@admin_denied {
path /admin /admin/*
not client_ip VOTRE_IP
}
abort @admin_denied
reverse_proxy 127.0.0.1:8222 {
header_up X-Real-IP {remote_host}
}
}Seule VOTRE_IP peut atteindre /admin : les autres connexions sont coupées sans réponse. Si vous accédez à Internet en IPv6, ajoutez aussi votre adresse IPv6 à la suite de client_ip. L’en-tête X-Real-IP permet à Vaultwarden de journaliser l’adresse réelle des visiteurs.
Validez et appliquez la configuration :
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo -u caddy caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddyVérifier le résultat
curl -I http://vault.votre-domaine.com
curl -fsS https://vault.votre-domaine.com/alive
sudo ss -ltnp | grep 8222La première commande doit renvoyer une redirection 308 vers HTTPS et la deuxième une date. La troisième doit montrer 127.0.0.1:8222 et aucune adresse publique.
Depuis votre poste, http://VOTRE_IP_SERVEUR:8222 ne doit pas répondre. Depuis une connexion qui n’utilise pas VOTRE_IP, par exemple un téléphone en données mobiles, https://vault.votre-domaine.com/admin doit échouer.
Étape 5 : créer votre compte par invitation
Les inscriptions étant fermées, le premier compte passe par une invitation de l’administrateur.
- Ouvrez
https://vault.votre-domaine.com/admindepuisVOTRE_IP. - Saisissez le mot de passe généré à l’étape 2, et non son empreinte.
- Dans l’onglet Users, utilisez le bloc Invite User avec votre adresse e-mail.
- Sans serveur SMTP, aucun message n’est envoyé. Ouvrez directement
https://vault.votre-domaine.com/#/signupet inscrivez-vous avec la même adresse. - Choisissez un mot de passe maître long et unique, puis connectez-vous.
Activez ensuite une méthode de connexion en deux étapes dans les paramètres de sécurité du compte, et conservez son code de récupération hors du coffre.
Dans les applications Bitwarden pour ordinateur, mobile ou navigateur, choisissez un serveur auto-hébergé sur l’écran de connexion, puis indiquez https://vault.votre-domaine.com.
Étape 6 : réduire la surface d’attaque
Une fois vos comptes créés, ajoutez cette ligne dans environment pour que les membres d’une organisation ne puissent plus inviter de nouveaux utilisateurs :
INVITATIONS_ALLOWED: "false"Si vous n’utilisez plus la page d’administration, désactivez-la en retirant la ligne ADMIN_TOKEN de compose.yaml. Vérifiez aussi qu’aucune clé admin_token n’existe dans vw-data/config.json, si ce fichier est présent. Appliquez ensuite les changements :
cd /opt/vaultwarden
sudo docker compose up -dPour inviter plus tard une nouvelle personne, rétablissez temporairement ADMIN_TOKEN, retirez INVITATIONS_ALLOWED, puis recréez le conteneur de la même façon.
Mettre à jour Vaultwarden
Consultez les notes de version, lancez une sauvegarde avec le service créé dans la section suivante, puis remplacez le numéro de version dans compose.yaml :
cd /opt/vaultwarden
sudo systemctl start vaultwarden-backup.service
sudo nano compose.yaml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs --tail=50 vaultwardenDepuis la version 1.37.5, une valeur de configuration invalide empêche le démarrage. Si le conteneur redémarre en boucle, lisez ses journaux.
Sauvegarder automatiquement
Le script suivant crée une copie cohérente de la base avec la commande intégrée à Vaultwarden, puis archive les fichiers utiles. Le cache d’icônes est volontairement ignoré.
sudo nano /usr/local/sbin/vaultwarden-backup.sh#!/bin/sh
set -eu
umask 077
APP_DIR=/opt/vaultwarden
DEST=/var/backups/vaultwarden
STAMP=$(date +%F-%H%M)
WORK=$(mktemp -d)
trap 'rm -rf "$WORK"' EXIT
mkdir -p "$DEST" "$WORK/data"
cd "$APP_DIR"
docker compose exec -T vaultwarden /vaultwarden backup
DB=$(ls -1t vw-data/db_*.sqlite3 | head -n 1)
mv "$DB" "$WORK/data/db.sqlite3"
for item in vw-data/attachments vw-data/sends vw-data/config.json vw-data/rsa_key*; do
if [ -e "$item" ]; then
cp -a "$item" "$WORK/data/"
fi
done
cp -a compose.yaml .env "$WORK/"
tar -czf "$DEST/vaultwarden-$STAMP.tar.gz" -C "$WORK" .
find "$DEST" -name 'vaultwarden-*.tar.gz' -mtime +14 -deleteCréez le service /etc/systemd/system/vaultwarden-backup.service :
[Unit]
Description=Vaultwarden backup
Requires=docker.service
After=docker.service
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/vaultwarden-backup.shPuis le minuteur /etc/systemd/system/vaultwarden-backup.timer :
[Unit]
Description=Daily Vaultwarden backup
[Timer]
OnCalendar=*-*-* 03:15:00
RandomizedDelaySec=15m
Persistent=true
[Install]
WantedBy=timers.targetActivez le tout et lancez une première sauvegarde :
sudo chmod 700 /usr/local/sbin/vaultwarden-backup.sh
sudo systemctl daemon-reload
sudo systemctl enable --now vaultwarden-backup.timer
sudo systemctl start vaultwarden-backup.service
sudo ls -lh /var/backups/vaultwardenLes archives restent 14 jours sur le serveur, ce qui ne protège pas contre sa perte. Copiez-les régulièrement ailleurs. Elles contiennent notamment .env et la clé rsa_key.pem : chiffrez-les si la destination n’est pas sous votre contrôle, par exemple avec gpg --symmetric --cipher-algo AES256 archive.tar.gz.
| Élément | Contenu | Sauvegarde |
|---|---|---|
db.sqlite3 |
Comptes, coffres chiffrés, organisations | Indispensable |
attachments/ |
Pièces jointes | Indispensable |
rsa_key* |
Signature des sessions | Recommandée |
config.json |
Réglages enregistrés depuis /admin |
Recommandée |
sends/ |
Fichiers des Sends | Facultative |
icon_cache/ |
Icônes des sites | Inutile |
Tester la restauration
Une sauvegarde n’a de valeur que si elle se restaure. Ce test lance une copie isolée sur un autre port, sans toucher à l’instance en service.
Extrayez la dernière archive et contrôlez la base :
sudo apt install -y sqlite3
sudo install -d -m 700 /root/vw-restore-test
sudo sh -c 'tar -xzf "$(ls -1t /var/backups/vaultwarden/*.tar.gz | head -n 1)" -C /root/vw-restore-test'
sudo sqlite3 /root/vw-restore-test/data/db.sqlite3 'PRAGMA integrity_check;'La dernière commande doit afficher ok. Démarrez ensuite la copie :
sudo docker run -d --rm --name vaultwarden-restore-test \
-e DOMAIN=http://localhost:8223 \
-e SIGNUPS_ALLOWED=false \
-v /root/vw-restore-test/data:/data \
-p 127.0.0.1:8223:80 \
vaultwarden/server:1.37.5
curl -fsS http://127.0.0.1:8223/aliveDepuis votre poste, ouvrez un tunnel SSH :
ssh -L 8223:127.0.0.1:8223 VOTRE_USER@VOTRE_IP_SERVEUROuvrez http://localhost:8223, connectez-vous avec votre compte, puis vérifiez qu’une entrée récente et une pièce jointe s’ouvrent correctement. Les navigateurs considèrent localhost comme un contexte sécurisé, ce qui permet ce test sans certificat.
Fermez le tunnel, puis supprimez la copie :
sudo docker stop vaultwarden-restore-test
sudo rm -rf /root/vw-restore-testRefaites ce test après chaque changement important, et au moins une fois par trimestre.
Restaurer en production
Remplacez le nom de l’archive par celui de la sauvegarde choisie. Sur un nouveau serveur, restaurez d’abord compose.yaml et .env dans /opt/vaultwarden, depuis la racine de l’archive.
ARCHIVE=/var/backups/vaultwarden/vaultwarden-2026-11-18-0315.tar.gz
cd /opt/vaultwarden
sudo docker compose down
sudo mv vw-data "vw-data.old-$(date +%F)"
sudo install -d -m 700 /root/vw-restore
sudo tar -xzf "$ARCHIVE" -C /root/vw-restore
sudo cp -a /root/vw-restore/data /opt/vaultwarden/vw-data
sudo docker compose up -d
sudo rm -rf /root/vw-restoreConnectez-vous et contrôlez vos données avant de supprimer l’ancien dossier vw-data.old-*.
En cas de problème
The "argon2id" variable is not set
Docker Compose essaie d’interpréter les $ de l’empreinte. Elle doit se trouver dans .env, entre apostrophes, et compose.yaml doit seulement référencer ${VAULTWARDEN_ADMIN_TOKEN}. Vérifiez le résultat avec sudo docker compose config : les $ y apparaissent doublés, ce qui est normal à cet endroit.
The configured Argon2 PHC in ADMIN_TOKEN is invalid
La valeur reçue par Vaultwarden est incorrecte, souvent à cause de guillemets en trop ou de $ doublés dans .env. Contrôlez-la :
sudo docker exec vaultwarden printenv ADMIN_TOKENLa sortie doit commencer par $argon2id$, sans guillemets.
Invalid admin token, please try again.
Saisissez le mot de passe d’origine, pas l’empreinte. Si vous l’avez perdu, générez-en un nouveau en reprenant l’étape 2, puis recréez le conteneur avec sudo docker compose up -d.
You are using a plain text ADMIN_TOKEN which is insecure
Vaultwarden lit encore un jeton en clair. Le plus souvent, config.json a priorité sur compose.yaml :
sudo grep admin_token /opt/vaultwarden/vw-data/config.jsonRemplacez alors le jeton depuis la page /admin, dans le champ Admin token/Argon2 PHC.
The admin panel is disabled
Aucun jeton n’est configuré. Vérifiez la ligne ADMIN_TOKEN de compose.yaml et le contenu de .env, puis recréez le conteneur.
/admin ne répond plus
L’adresse IP de votre poste a probablement changé. Corrigez client_ip dans le Caddyfile, puis validez et rechargez Caddy.
Registration not allowed or user already exists
L’adresse saisie ne correspond pas à une invitation en attente, ou le compte existe déjà. Vérifiez l’adresse dans l’onglet Users de /admin. Si INVITATIONS_ALLOWED vaut false, retirez cette ligne le temps de l’inscription.
Une variable modifiée n’a aucun effet
Si vw-data/config.json existe, il remplace les variables d’environnement. Modifiez le réglage depuis /admin, ou retirez la clé concernée du fichier, conteneur arrêté.
Le coffre ne s’ouvre pas ou signale que HTTPS est requis
Vérifiez que vous utilisez bien l’adresse en https:// et que DOMAIN contient exactement cette adresse. L’accès par http://VOTRE_IP_SERVEUR n’est pas pris en charge.
Erreur 502 dans le navigateur
Caddy ne joint pas le conteneur :
cd /opt/vaultwarden
sudo docker compose ps
sudo docker compose logs --tail=50 vaultwarden
curl -fsS http://127.0.0.1:8222/alive