FR

Applications

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.

10 min de lecture, mis à jour le 18 novembre 2026

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

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 :

Terminal
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp
sudo ufw status

Si 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 :

Terminal
sudo mkdir -p /opt/vaultwarden
cd /opt/vaultwarden
openssl rand -base64 32

Conservez 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 :

Terminal
sudo docker run --rm -it vaultwarden/server:1.37.5 /vaultwarden hash

Elle affiche une ligne de cette forme :

Texte
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$...'

Créez le fichier .env :

Terminal
sudo nano /opt/vaultwarden/.env

Collez-y l’empreinte, entre apostrophes et sans doubler les $ :

Terminal
VAULTWARDEN_ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$...'

Protégez le fichier :

Terminal
sudo chmod 600 /opt/vaultwarden/.env

Étape 3 : écrire le fichier Compose

Terminal
sudo nano /opt/vaultwarden/compose.yaml
YAML
services:
  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 :

Terminal
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/alive

La 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 :

caddyfile
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 :

Terminal
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo -u caddy caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy

Vérifier le résultat

Terminal
curl -I http://vault.votre-domaine.com
curl -fsS https://vault.votre-domaine.com/alive
sudo ss -ltnp | grep 8222

La 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.

  1. Ouvrez https://vault.votre-domaine.com/admin depuis VOTRE_IP.
  2. Saisissez le mot de passe généré à l’étape 2, et non son empreinte.
  3. Dans l’onglet Users, utilisez le bloc Invite User avec votre adresse e-mail.
  4. Sans serveur SMTP, aucun message n’est envoyé. Ouvrez directement https://vault.votre-domaine.com/#/signup et inscrivez-vous avec la même adresse.
  5. 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 :

YAML
      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 :

Terminal
cd /opt/vaultwarden
sudo docker compose up -d

Pour 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 :

Terminal
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 vaultwarden

Depuis 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é.

Terminal
sudo nano /usr/local/sbin/vaultwarden-backup.sh
Terminal
#!/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 -delete

Créez le service /etc/systemd/system/vaultwarden-backup.service :

Configuration
[Unit]
Description=Vaultwarden backup
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
ExecStart=/usr/local/sbin/vaultwarden-backup.sh

Puis le minuteur /etc/systemd/system/vaultwarden-backup.timer :

Configuration
[Unit]
Description=Daily Vaultwarden backup

[Timer]
OnCalendar=*-*-* 03:15:00
RandomizedDelaySec=15m
Persistent=true

[Install]
WantedBy=timers.target

Activez le tout et lancez une première sauvegarde :

Terminal
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/vaultwarden

Les 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 :

Terminal
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 :

Terminal
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/alive

Depuis votre poste, ouvrez un tunnel SSH :

Terminal
ssh -L 8223:127.0.0.1:8223 VOTRE_USER@VOTRE_IP_SERVEUR

Ouvrez 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 :

Terminal
sudo docker stop vaultwarden-restore-test
sudo rm -rf /root/vw-restore-test

Refaites 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.

Terminal
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-restore

Connectez-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 :

Terminal
sudo docker exec vaultwarden printenv ADMIN_TOKEN

La 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 :

Terminal
sudo grep admin_token /opt/vaultwarden/vw-data/config.json

Remplacez 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 :

Terminal
cd /opt/vaultwarden
sudo docker compose ps
sudo docker compose logs --tail=50 vaultwarden
curl -fsS http://127.0.0.1:8222/alive

Références