Vaultwarden
Un mot de passe différent par site, c'est impossible à retenir, alors on finit par réutiliser les mêmes. Installons Vaultwarden, un coffre à mots de passe qui tourne sur votre propre serveur.
- Parcours
- Tutoriel 25 sur 35
- Durée
- 45 min de lecture
- Vérifié avec
- Vaultwarden 1.37.5, Docker 29.7.2, Apache 2.4 (Debian 13.7)
Ce que vous saurez faire
- Lancer Vaultwarden avec un fichier Compose, sans l'exposer sur Internet.
- Créer votre compte en privé, puis fermer les inscriptions aux inconnus.
- Le publier derrière Apache en HTTPS, ce que les applications exigent.
- Sauvegarder le volume, restaurer, exporter le coffre et mettre à jour.
Avant de commencer : Docker et Docker Compose, HTTPS avec Let's Encrypt, Reverse proxy.
Sommaire
Comment héberger son propre gestionnaire de mots de passe avec Vaultwarden ? Il faut un petit fichier de configuration d'une quinzaine de lignes, un nom de domaine en HTTPS et un peu de soin avec les inscriptions. Comptez trois quarts d'heure, étape facultative comprise. Vous obtiendrez un coffre qui remplit vos mots de passe depuis votre navigateur et votre téléphone, et dont les données restent chez vous. Les post-it sous le clavier peuvent prendre leur retraite.
Deux repères avant de commencer. Le serveur est l'ordinateur loué qui tourne en permanence et que vous pilotez à distance : les blocs « Sur le serveur » se tapent dans un terminal connecté à lui (voir Première connexion en SSH), les blocs « Sur votre ordinateur » dans un terminal ouvert chez vous. Et exemple.fr, vault.exemple.fr et 203.0.113.10 sont des exemples : remplacez-les par votre propre nom de domaine et l'adresse de votre serveur.
Ce que fait Vaultwarden
Un gestionnaire de mots de passe est un coffre-fort numérique : il retient à votre place un mot de passe long et différent pour chaque site. Vous n'en retenez qu'un, le mot de passe maître, qui ouvre le coffre. Vaultwarden est le serveur de ce coffre, que vous hébergez vous-même.
Il parle le même langage que Bitwarden, un service connu du même genre. Vous utilisez donc les applications et les extensions de navigateur officielles de Bitwarden, et vous leur indiquez simplement l'adresse de votre serveur au lieu de celle de Bitwarden.
Le coffre est chiffré sur votre appareil, c'est-à-dire brouillé par une clé tirée de votre mot de passe maître, avant d'être envoyé. Le serveur ne garde qu'un texte illisible. Il reste donc deux choses à protéger : l'accès au serveur et ce mot de passe maître. Nous ajouterons une deuxième serrure à l'étape 3.
Une règle s'impose : sur Internet, le coffre web exige le HTTPS, la version chiffrée du web (adresse en https://). Sans lui, le navigateur coupe ses outils de chiffrement, et les applications Bitwarden refusent aussi l'adresse. Let's Encrypt fournit gratuitement le certificat qui l'autorise. Une seule exception : l'adresse localhost, qui désigne votre propre ordinateur et que le navigateur juge sûre. Notre ordre sera donc : démarrer le conteneur, créer votre compte en privé par un tunnel SSH (étape 3), fermer les inscriptions, puis publier en HTTPS.
1Écrire le fichier Compose
Vaultwarden tient dans un seul conteneur, sans base de données à part : il range tout dans SQLite, une base de données qui tient dans un seul fichier. Un conteneur est un programme lancé dans sa boîte isolée. Docker Compose lit un fichier qui décrit cette boîte. Un volume est un dossier qui garde les données quand la boîte est remplacée. Le détail est dans Docker et Docker Compose. Créons le dossier et le fichier.
mkdir -p ~/vaultwarden
cd ~/vaultwarden
cat > docker-compose.yml <<'EOF'
services:
vaultwarden:
image: vaultwarden/server:1.37.5
restart: unless-stopped
environment:
DOMAIN: https://vault.exemple.fr
SIGNUPS_ALLOWED: "true"
volumes:
- vw-data:/data
ports:
- 127.0.0.1:8083:80
volumes:
vw-data:
EOFVoici le rôle de chaque ligne qui compte :
image: l'image officielle de Vaultwarden, dans une version précise. Changer ce numéro est la seule façon de mettre à jour (étape 8).restart: unless-stopped: Docker relance le conteneur après un plantage ou un redémarrage du serveur, sauf si vous l'avez arrêté vous-même.DOMAIN: l'adresse publique complète, avechttps://. Vaultwarden s'en sert pour écrire ses liens.SIGNUPS_ALLOWED: à"true", n'importe qui peut créer un compte. Nous le laissons ouvert le temps de créer votre compte, puis l'étape 4 le ferme.vw-data:/data: le volume. Le coffre, c'est-à-dire la base et les clés du serveur, vit dans/dataet survit à toute mise à jour du conteneur.127.0.0.1:8083:80: le port 8083 du serveur mène au port 80 du conteneur, et seulement pour le serveur lui-même.
Le fichier est prêt. Lançons le conteneur et vérifions qu'il répond.
2Démarrer et vérifier
La commande up -d télécharge l'image, ce qui prend une minute la première fois, puis lance le conteneur en arrière-plan.
cd ~/vaultwarden
sudo docker compose up -dVaultwarden met quelques secondes à démarrer. Il offre une adresse de contrôle, /alive, qui répond par la date du moment.
curl -s http://127.0.0.1:8083/alive"2026-11-05T02:58:41.869772Z"Une date entre guillemets s'affiche, et la vôtre sera différente. Si rien ne s'affiche, patientez dix secondes et relancez la commande. Vérifions maintenant, avec ss -ltn qui liste les ports en écoute, que celui-ci n'est ouvert qu'au serveur.
ss -ltn | grep 8083LISTEN 0 65535 127.0.0.1:8083 0.0.0.0:*L'adresse 127.0.0.1 confirme que seul le serveur atteint ce port. Personne ne peut donc s'inscrire avant vous : créons votre compte avant de rien publier.
3Créer votre compte par un tunnel SSH
Le site n'est pas public : c'est le bon moment pour créer votre compte. Pour atteindre le port 8083 depuis votre ordinateur, ouvrez un tunnel SSH, une connexion SSH qui prête un port du serveur à votre ordinateur. Dans la commande, -L 8083:127.0.0.1:8083 veut dire que le port 8083 de votre ordinateur mène au port 8083 du serveur. Laissez cette fenêtre ouverte.
ssh -L 8083:127.0.0.1:8083 alice@203.0.113.10Ouvrez ensuite http://localhost:8083 dans le navigateur. Le navigateur accepte ici le coffre sans HTTPS, parce que localhost reste sur votre ordinateur. Choisissez de créer un compte. Le formulaire demande trois informations :
- Votre adresse e-mail : elle sert d'identifiant.
- Un nom : celui que vous voulez voir affiché.
- Le mot de passe maître : le seul que vous retiendrez désormais.
Choisissez pour le mot de passe maître une phrase longue, par exemple quatre ou cinq mots sans rapport entre eux, que vous n'utilisez nulle part ailleurs. La longueur compte plus que les symboles, et une phrase se retient mieux qu'un code.
Connectez-vous ensuite avec ce compte, puis ajoutez une deuxième serrure : la connexion en deux étapes. Elle demande, en plus du mot de passe maître, un code à six chiffres qui change toutes les trente secondes. Ce code vient d'une application d'authentification, une petite appli gratuite à installer sur votre téléphone (FreeOTP ou Aegis, par exemple ; cherchez « authentificateur » dans la boutique d'applications de votre téléphone). Dans les paramètres du compte, rubrique sécurité, activez-la et suivez les indications. Notez aussi le code de récupération qu'on vous donne, au même endroit que le mot de passe maître. Votre compte existe : reste à refermer la porte.
4Fermer les inscriptions
Tant que SIGNUPS_ALLOWED vaut "true", n'importe qui connaissant l'adresse peut créer un compte sur votre serveur. Passez-le à "false", puis recréez le conteneur : le volume, donc votre coffre, reste en place.
cd ~/vaultwarden
sed -i 's/SIGNUPS_ALLOWED: "true"/SIGNUPS_ALLOWED: "false"/' docker-compose.yml
sudo docker compose up -dVérifions que la porte est bien fermée en tentant une inscription. Cette commande demande un compte pour l'adresse test@exemple.fr ; Vaultwarden doit refuser.
curl -s -H 'Content-Type: application/json' -d '{"email":"test@exemple.fr","name":"test","receiveMarketingEmails":false}' http://127.0.0.1:8083/identity/accounts/register/send-verification-email | grep -o '"message":"[^"]*"' | head -1"message":"Registration not allowed or user already exists"Le refus est net. Pour accueillir plus tard une autre personne, le plus propre est d'inviter son adresse e-mail depuis le panneau d'administration, présenté après l'étape 8 : les inscriptions restent fermées pour tous les autres. Sinon, remettez "true", recréez le conteneur, laissez la personne s'inscrire, puis refermez aussitôt.
Votre serveur n'accepte plus de nouveaux comptes. Fermez la fenêtre du tunnel avec exit : le coffre est prêt et verrouillé, reste à le publier.
5Passer en HTTPS derrière Apache
Le conteneur parle en HTTP simple. Apache, le serveur web, lui apporte le HTTPS en recevant les visiteurs à sa place : c'est un proxy inverse, expliqué dans Reverse proxy. Votre compte existe et les inscriptions sont fermées : vous pouvez publier. Nous écrivons d'abord un site provisoire, qui ne proxifie rien. Il sert à Certbot, l'outil qui demande le certificat à Let's Encrypt, pour prouver que le domaine est à vous. Le site définitif, avec le proxy, vient ensuite.
Commencez chez votre fournisseur de nom de domaine : ajoutez un enregistrement de type A, la ligne d'un carnet d'adresses qui relie un nom à une adresse IP. Ici, il relie vault.exemple.fr à 203.0.113.10. Activez ensuite avec a2enmod les modules de proxy et de HTTPS d'Apache : ce sont les options dont il a besoin ici (Premier site avec Apache présente Apache et ces commandes). La commande ne change rien s'ils le sont déjà.
sudo a2enmod proxy proxy_http headers ssl
sudo systemctl restart apache2Voici le site provisoire : le port 80 ne mène pas encore à votre coffre.
sudo tee /etc/apache2/sites-available/vault.exemple.fr.conf > /dev/null <<'EOF'
<VirtualHost *:80>
ServerName vault.exemple.fr
</VirtualHost>
EOFActivons le site avec a2ensite. Vérifions la syntaxe avec configtest, qui relit les fichiers de réglages et signale une faute de frappe avant qu'elle ne casse le site. Rechargeons enfin avec reload, qui applique les nouveaux réglages sans couper les visiteurs en cours. Demandons ensuite le certificat. Avec certonly, Certbot prouve que le domaine est à vous, récupère le certificat et ne touche à aucun fichier Apache.
sudo a2ensite vault.exemple.fr.conf
sudo apache2ctl configtest
sudo systemctl reload apache2
sudo certbot certonly --apache -d vault.exemple.frLe certificat est prêt dans /etc/letsencrypt/live/vault.exemple.fr/. Réécrivons maintenant le site en version définitive : le port 80 redirige vers le HTTPS, et le proxy n'existe que du côté HTTPS.
sudo tee /etc/apache2/sites-available/vault.exemple.fr.conf > /dev/null <<'EOF'
<VirtualHost *:80>
ServerName vault.exemple.fr
Redirect permanent / https://vault.exemple.fr/
</VirtualHost>
<VirtualHost *:443>
ServerName vault.exemple.fr
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/vault.exemple.fr/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/vault.exemple.fr/privkey.pem
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:8083/ upgrade=websocket
ProxyPassReverse / http://127.0.0.1:8083/
RequestHeader set X-Forwarded-Proto "https"
ErrorLog ${APACHE_LOG_DIR}/vault-error.log
CustomLog ${APACHE_LOG_DIR}/vault-access.log combined
</VirtualHost>
EOFL'option upgrade=websocket laisse passer les WebSocket, des connexions que le navigateur garde ouvertes. Vaultwarden s'en sert pour prévenir vos appareils dès qu'un mot de passe change. L'Apache de Debian 13 est assez récent pour elle. Vérifions la syntaxe et rechargeons.
sudo apache2ctl configtest
sudo systemctl reload apache2Syntax OKEt le module proxy_wstunnel, cité dans d'autres articles ?
Les Apache plus anciens (avant la 2.4.47) avaient besoin de ce module pour les WebSocket. Ce n'est plus le cas : avec l'option upgrade=websocket, la connexion s'établit sans lui, ce que nous avons vérifié sur un Apache 2.4 isolé. Sans l'option, Apache refuse avec l'erreur 426 (« changement de protocole requis »), même avec le module chargé.
Testons depuis votre ordinateur, avec la même adresse de contrôle que tout à l'heure.
curl -s https://vault.exemple.fr/aliveUne date entre guillemets doit s'afficher, cette fois à travers Apache et en HTTPS. Le coffre est enfin joignable, et seulement en HTTPS.
Il reste à brancher vos appareils. Dans l'extension de navigateur ou l'application Bitwarden, choisissez avant la connexion l'option de serveur auto-hébergé, et saisissez l'adresse https://vault.exemple.fr. Connectez-vous avec le compte créé à l'étape 3. Reste à protéger ce qu'il contient.
6Sauvegarder le volume
Tout ce que Vaultwarden retient est dans le volume : sauvegarder, c'est en copier le contenu. Arrêtez d'abord le conteneur, car une base SQLite copiée pendant qu'on y écrit peut sortir abîmée. La copie se fait avec tar, qui range des fichiers dans une archive. Il tourne dans un conteneur jetable, fait avec alpine:3.20, une petite image Linux.
Compose ajoute le nom du dossier devant celui du volume : ici, il s'appelle vaultwarden_vw-data. Docker crée l'archive au nom de root, le compte administrateur.
La dernière ligne du bloc corrige cela : chown remet l'archive à votre nom, et chmod 600 la réserve à vous seul.
cd ~/vaultwarden
sudo docker compose stop
sudo docker run --rm -v vaultwarden_vw-data:/donnees:ro -v "$PWD":/sauvegarde alpine:3.20 tar czf /sauvegarde/vaultwarden-donnees.tar.gz -C /donnees .
sudo docker compose start
sudo chown "$USER" vaultwarden-donnees.tar.gz && chmod 600 vaultwarden-donnees.tar.gzLe coffre n'est hors ligne que quelques secondes. Vérifions que l'archive contient bien la base (db.sqlite3) et la clé privée du serveur (rsa_key.pem, qui sert à signer les connexions de vos appareils) : la commande doit afficher 2.
tar tzf vaultwarden-donnees.tar.gz | grep -c -E 'db.sqlite3$|rsa_key.pem$'2Le contenu du coffre est chiffré, mais cette archive ne doit pas traîner : quiconque la copie peut s'attaquer à votre mot de passe maître tranquillement, chez lui. Copiez-la sur un autre ordinateur, par exemple avec rsync, car une sauvegarde qui reste sur le serveur ne protège pas d'une panne du serveur.
Restaurer une sauvegarde
Restaurer, c'est remettre l'archive dans le volume, conteneur arrêté. Les fichiers de l'archive remplacent ceux du volume.
cd ~/vaultwarden
sudo docker compose stop
sudo docker run --rm -v vaultwarden_vw-data:/donnees -v "$PWD":/sauvegarde alpine:3.20 tar xzf /sauvegarde/vaultwarden-donnees.tar.gz -C /donnees
sudo docker compose startL'archive couvre le cas où le serveur tombe. Pour le cas où vous voulez quitter Vaultwarden, il faut une autre copie.
7Exporter le coffre
Un export est une copie de vos mots de passe dans un fichier que d'autres gestionnaires savent lire. Dans le coffre web, ouvrez le menu des outils, choisissez l'export du coffre, puis un format. JSON et CSV sont des fichiers texte que beaucoup d'outils lisent. Préférez le JSON chiffré : un mot de passe, fixé à ce moment-là, le protège.
Refaites cet export de temps en temps et gardez-le avec la sauvegarde du volume : deux copies de formes différentes valent mieux qu'une. Voyons enfin comment suivre les nouvelles versions.
8Mettre à jour
Une mise à jour remplace le conteneur par un autre, plus récent, qui reprend le même volume. Sauvegardez d'abord comme à l'étape 6. Changez ensuite le numéro après vaultwarden/server: dans le fichier : ouvrez-le avec nano ~/vaultwarden/docker-compose.yml (Ctrl+O et Entrée enregistrent, Ctrl+X quitte ; Le terminal pour débutants détaille nano). Puis téléchargez et recréez.
cd ~/vaultwarden
sudo docker compose pull
sudo docker compose up -dPour lire la version qui tourne, interrogez le conteneur.
sudo docker compose exec vaultwarden /vaultwarden --versionVaultwarden 1.37.5Le numéro affiché doit être celui que vous avez écrit dans le fichier. Reste un réglage facultatif, pour inviter d'autres personnes.
Facultatif : le panneau d'administration
Les inscriptions sont fermées : comment accueillir quelqu'un d'autre ? Le panneau d'administration répond. Sautez ce chapitre si vous êtes seul.
Vaultwarden a une page d'administration, /admin, pour inviter des gens ou supprimer des comptes. Elle reste désactivée tant que vous ne définissez pas un jeton, un mot de passe propre à cette page. Ne l'écrivez jamais en clair : Vaultwarden accepte à la place son empreinte, un texte calculé à partir du jeton, qui ne permet pas de retrouver le jeton. Pour la calculer, la commande ci-dessous lance Vaultwarden le temps d'un calcul. Elle vous demande le jeton deux fois, sans l'afficher : tapez-le sans rien voir, puis Entrée.
Pourquoi ce calcul est lent
Le calcul de l'empreinte (Argon2id) est volontairement lent, pour décourager les essais en série. L'option -it de la commande sert à vous laisser taper le jeton.
sudo docker run --rm -it vaultwarden/server:1.37.5 /vaultwarden hashGenerate an Argon2id PHC string using the 'bitwarden' preset:
Password:
Confirm Password:
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$M4CpooFicL0/uv1ja+9/r6e2Gh6u5CyDxqmjhcrKu/4$RFVUgDqN8nEmNz6vpmDtA53Ql1+YoD4kmpy3g36qxuE'L'empreinte affichée ici vient d'un jeton d'exemple : la vôtre sera différente à chaque fois. Rangez-la dans un fichier .env, un petit fichier de réglages que Compose lit tout seul. Le bloc ci-dessous le crée lisible par vous seul, puis l'ouvre dans l'éditeur nano.
cd ~/vaultwarden
install -m 600 /dev/null .env
nano .envDans nano, collez la ligne ADMIN_TOKEN= telle qu'elle s'affiche (sélectionnez-la avec la souris dans le terminal et copiez avec Ctrl+Maj+C, ou Cmd+C sur un Mac ; collez ensuite avec Ctrl+Maj+V, ou Cmd+V), apostrophes comprises. Sans elles, Compose prendrait chaque signe $ pour le début d'un nom à remplacer, et abîmerait l'empreinte. Puis Ctrl+O et Entrée enregistrent, Ctrl+X quitte.
Dans docker-compose.yml, ajoutez sous environment:, avec la même indentation que DOMAIN, la ligne suivante, puis recréez le conteneur.
ADMIN_TOKEN: ${ADMIN_TOKEN}sudo docker compose up -dLa page https://vault.exemple.fr/admin demande alors votre jeton, celui que vous avez tapé, pas l'empreinte. Pour inviter quelqu'un, ouvrez l'onglet des utilisateurs, saisissez son adresse e-mail et validez.
Sans serveur de courrier configuré, aucun message ne part : prévenez la personne, qui s'inscrit sur la page de votre coffre avec exactement cette adresse. Les inscriptions restent fermées pour tous les autres. Pour désactiver le panneau, retirez la ligne et recréez le conteneur.
Si ça échoue
Cinq situations sont à connaître. Dans tous les cas, sudo docker compose logs montre ce que Vaultwarden raconte :
- La création de compte échoue ou la page reste vide. Vous êtes probablement en HTTP. Ouvrez l'adresse en
https://, car le navigateur refuse le chiffrement sur une page non sécurisée. Registration not allowed or user already exists. Les inscriptions sont fermées (étape 4), ou l'adresse e-mail a déjà un compte. Pour inscrire quelqu'un, invitez-le depuis le panneau d'administration, ou rouvrez les inscriptions le temps qu'il crée son compte.The admin panel is disabled, please configure the 'ADMIN_TOKEN' variable to enable it. Aucun jeton n'est défini : c'est le réglage normal, sans panneau d'administration.Invalid admin token, please try again.Vous avez saisi l'empreinte au lieu du jeton, ou le jeton a une faute. Tapez celui que vous avez choisi au moment de la commandehash.- Une erreur 503 d'Apache. Le conteneur est arrêté ou n'écoute pas le port 8083. Lancez
sudo docker compose ps: si le conteneur n'est pas « Up », relancez-le avecsudo docker compose up -det lisezsudo docker compose logs.
La suite
Vos mots de passe sont chez vous, en HTTPS, avec une sauvegarde et un export. Une question reste : faut-il vraiment que tout votre serveur soit visible sur Internet ? Pour certains services, la réponse est non, et un tunnel privé entre vos appareils et votre serveur règle le problème. L'article suivant, WireGuard, le met en place.