Vaultwarden est un serveur libre, écrit en Rust, qui parle le même protocole que Bitwarden. Les applications Bitwarden officielles (extension de navigateur, appli mobile, bureau, ligne de commande) s'y connectent comme à un serveur Bitwarden. Le coffre de vos mots de passe vit alors sur une machine que vous administrez, ici une Nano à Montréal.
Nous avons tout monté et vérifié sur une Nano facturée à l'heure, sous Debian 13 :
Vaultwarden 1.37.5 dans Docker, HTTPS par Caddy et Let's Encrypt, page
d'administration protégée par un jeton haché, inscriptions fermées, client
bw officiel connecté et synchronisé, fail2ban qui bannit vraiment,
sauvegarde restaurée et mise à jour d'une version à l'autre.
1. Vaultwarden n'est pas Bitwarden
Vaultwarden est un projet communautaire, sans lien avec l'entreprise Bitwarden. Il le rappelle lui-même au démarrage : « This is an *unofficial* Bitwarden implementation, DO NOT use the official channels to report bugs/features ». Un problème se signale sur le GitHub de Vaultwarden, jamais au soutien de Bitwarden.
Le chiffrement, lui, se fait dans les clients officiels. Le serveur ne reçoit que des
données déjà chiffrées avec une clé dérivée de votre mot de passe maître. Nous l'avons
vérifié : après avoir créé une entrée dont le mot de passe était
essai-blog-07, une recherche de cette chaîne dans
db.sqlite3 ne trouve rien, et la colonne des données commence par
2., le préfixe des chaînes chiffrées de Bitwarden. Un mot de passe maître oublié ne se récupère pas, comme avec Bitwarden.
2. Pourquoi l'héberger au Canada
Un gestionnaire de mots de passe d'entreprise contient les accès à tout le reste. Le garder sur un serveur à Montréal, exploité par une entreprise canadienne, simplifie la question de la Loi 25 sur les communications hors Québec. Nous avons détaillé ce que la loi exige et ce que change le CLOUD Act dans Héberger ses données au Canada ; nous n'y revenons pas ici.
3. La machine et le nom de domaine
Une Nano suffit : 1 vCPU, 2 Go de mémoire, 20 Go de disque, 0,018 CAD l'heure ou 8,50 CAD par mois. Gardez l'IPv4 publique : les applications de vos utilisateurs doivent joindre le serveur depuis n'importe quel réseau.
Chaque VM reçoit un nom de domaine, affiché dans la console et renvoyé par l'API dans
le champ dns_name (de la forme vm-xxxxxxxxx.ffxf.zone), avec
ses enregistrements A et AAAA déjà en place. C'est ce nom que nous avons utilisé. Pour
servir coffre.votre-domaine.ca, créez chez votre registraire un
enregistrement A vers l'IPv4 de la machine et un AAAA vers son IPv6, puis mettez ce
nom à la place de celui de la VM dans DOMAIN et dans le
Caddyfile.
Le catalogue propose aussi une image Vaultwarden. Nous l'avons déployée sur une
seconde Nano : elle démarre en HTTPS sur le nom de la VM, avec un jeton
d'administration généré dans /opt/vaultwarden/.env. Lors de notre essai, deux
choses étaient à corriger : le jeton était en clair (Vaultwarden l'affiche dans ses
journaux) et les inscriptions étaient ouvertes, n'importe qui pouvait commencer à créer
un compte. Nous avons corrigé l'image depuis : elle ferme les inscriptions, range le
jeton haché en Argon2id et transmet la vraie adresse des clients pour fail2ban. Si vous
l'avez déployée avant le 3 novembre 2026, appliquez les sections 5 et 6 et ajoutez
- SIGNUPS_ALLOWED=false sous environment: dans
/opt/vaultwarden/compose.yml.
4. Installer Docker, Caddy et fail2ban
Sur Debian 13, Docker vient de son dépôt officiel, Caddy et fail2ban des paquets Debian. Caddy tourne sur l'hôte plutôt qu'en conteneur : fail2ban bloque alors le trafic dans la chaîne d'entrée du système, sans les détours des règles de Docker.
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
https://download.docker.com/linux/debian $(. /etc/os-release && echo $VERSION_CODENAME) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin \
caddy fail2ban sqlite3
5. Un jeton d'administration haché
La page /admin donne la main sur tous les comptes. Vaultwarden accepte un
jeton en clair, mais recommande d'y mettre une empreinte Argon2id. Sa commande
hash demande le mot de passe deux fois et exige un terminal : lancée sans
-it, elle plante sur « No such device or address ».
sudo mkdir -p /opt/vaultwarden && cd /opt/vaultwarden
sudo docker run --rm -it vaultwarden/server:1.37.5 /vaultwarden hash
Elle répond par une ligne ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$…'
(165 ms de calcul sur la Nano). Gardez les apostrophes : sans elles, les
$ de l'empreinte seraient lus comme des variables. Le mot de passe saisi
est celui de la page /admin, rangez-le dans un autre coffre.
Créez /opt/vaultwarden/.env (droits 600) en y collant cette
ligne :
DOMAIN=https://vm-xxxxxxxxx.ffxf.zone
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$…'
SIGNUPS_ALLOWED=false
INVITATIONS_ALLOWED=false
IP_HEADER=X-Forwarded-For
LOG_FILE=/data/vaultwarden.log
Puis /opt/vaultwarden/compose.yml. Le port n'écoute que sur
127.0.0.1 : seul Caddy le joint.
services:
vaultwarden:
image: vaultwarden/server:1.37.5
container_name: vaultwarden
restart: unless-stopped
env_file: .env
volumes:
- ./data:/data
ports:
- "127.0.0.1:8000:80"
sudo chmod 600 /opt/vaultwarden/.env
sudo docker compose up -d
IP_HEADER=X-Forwarded-For n'est pas décoratif. Sans lui, Vaultwarden
cherche l'en-tête X-Real-IP, que Caddy n'envoie pas, et note l'adresse
de la passerelle Docker. Nous l'avons constaté : chaque échec de connexion était
journalisé avec IP: 172.18.0.1, ce qui rend fail2ban inutile.
6. HTTPS avec Caddy
Le HTTPS n'est pas une option : les clients Bitwarden refusent un serveur en HTTP. Le
CLI bw 2026.10.1 répond « Insecure URL not allowed. All URLs must use
HTTPS », même vers localhost. Remplacez le contenu de
/etc/caddy/Caddyfile :
vm-xxxxxxxxx.ffxf.zone {
encode zstd gzip
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
curl https://vm-xxxxxxxxx.ffxf.zone/alive
Caddy a obtenu le certificat Let's Encrypt quatre secondes après le rechargement et redirige le HTTP vers le HTTPS de lui-même.
7. Créer les comptes, inscriptions fermées
Avec SIGNUPS_ALLOWED=false, une inscription d'une adresse inconnue est
refusée (« Registration not allowed or user already exists »). Pour ajouter quelqu'un,
ouvrez https://votre-nom/admin, entrez le mot de passe de l'étape 5, et
invitez son adresse dans l'onglet Users. Sans serveur de courriel configuré,
aucun message ne part : la personne ouvre le coffre web et s'inscrit avec cette
adresse, qui est alors acceptée. Vérifié avec un compte invité, puis refusé pour un
compte qui ne l'était pas.
Une fois les comptes créés, vous pouvez retirer ADMIN_TOKEN du
.env et relancer le conteneur : selon la documentation de Vaultwarden, la page d'administration est alors désactivée.
8. Vérifier avec le client officiel
Le CLI Bitwarden (npm install -g @bitwarden/cli) suffit à prouver qu'un
client officiel fonctionne :
bw config server https://vm-xxxxxxxxx.ffxf.zone
bw login vous@exemple.ca
export BW_SESSION="…" # la valeur affichée par bw login
bw sync
bw list items
Nous avons créé une entrée depuis un premier client, puis ouvert une session neuve depuis un second : l'entrée y était, mot de passe compris. Une pièce jointe de 200 Ko et 50 entrées de plus se sont synchronisées de la même façon. Les extensions et les applis mobiles demandent la même adresse, dans le choix du serveur « auto-hébergé » ; nous ne les avons pas testées ici.
9. fail2ban sur les échecs de connexion
Vaultwarden écrit une ligne par mot de passe refusé et par jeton d'administration
invalide, avec l'adresse du client. Deux filtres, dans
/etc/fail2ban/filter.d/ :
# vaultwarden.local
[INCLUDES]
before = common.conf
[Definition]
failregex = ^.*?Username or password is incorrect\. Try again\. IP: <ADDR>\. Username:.*$
ignoreregex =
# vaultwarden-admin.local
[INCLUDES]
before = common.conf
[Definition]
failregex = ^.*Invalid admin token\. IP: <ADDR>.*$
ignoreregex =
Et les prisons, dans /etc/fail2ban/jail.d/vaultwarden.local. Sur
Debian, fail2ban bloque avec nftables ; backend = auto lui fait lire le
fichier plutôt que le journal systemd.
[vaultwarden]
enabled = true
port = 80,443
filter = vaultwarden
backend = auto
logpath = /opt/vaultwarden/data/vaultwarden.log
maxretry = 5
findtime = 15m
bantime = 4h
[vaultwarden-admin]
enabled = true
port = 80,443
filter = vaultwarden-admin
backend = auto
logpath = /opt/vaultwarden/data/vaultwarden.log
maxretry = 3
findtime = 15m
bantime = 4h
sudo systemctl restart fail2ban
sudo fail2ban-client status vaultwarden
Le test : cinq bw login avec un mauvais mot de passe. Au cinquième,
fail2ban a banni notre adresse IPv6 et les connexions HTTPS par IPv6 ont échoué.
Notre poste avait aussi une IPv4 : le client est passé par elle sans se plaindre, et
il a fallu quatre échecs de plus pour qu'elle soit bannie à son tour. Une même
personne peut donc arriver par deux adresses. Trois mauvais jetons sur
/admin ont déclenché la seconde prison. La connexion SSH, elle, est
restée ouverte, puisque seuls les ports 80 et 443 sont bloqués. Pour débloquer :
sudo fail2ban-client unban --all.
10. Sauvegarder la base et les pièces jointes
Tout est dans /opt/vaultwarden/data : db.sqlite3, le dossier
attachments, sends s'il existe et
rsa_key.pem, la clé qui signe les sessions. Ne copiez pas
db.sqlite3 pendant que le serveur écrit : la commande
.backup de SQLite produit une copie cohérente sans l'arrêter. Le script
/usr/local/bin/vw-backup :
#!/bin/sh
set -eu
umask 077
SRC=/opt/vaultwarden/data
DEST=/var/backups/vaultwarden
STAMP=$(date +%Y%m%d-%H%M)
TMP=$(mktemp -d)
mkdir -p "$DEST"
sqlite3 "$SRC/db.sqlite3" ".backup '$TMP/db.sqlite3'"
sqlite3 "$TMP/db.sqlite3" "PRAGMA integrity_check;" | grep -qx ok
cp -a "$SRC/rsa_key.pem" "$TMP/"
for d in attachments sends config.json; do
[ -e "$SRC/$d" ] && cp -a "$SRC/$d" "$TMP/"
done
tar -C "$TMP" -czf "$DEST/vaultwarden-$STAMP.tar.gz" .
rm -rf "$TMP"
find "$DEST" -name "vaultwarden-*.tar.gz" -mtime +14 -delete
Sans umask 077, notre première archive était lisible par tous les comptes
de la machine. Rendez le script exécutable (sudo chmod 700) et
planifiez-le chaque nuit avec un minuteur systemd :
# /etc/systemd/system/vw-backup.service
[Unit]
Description=Sauvegarde Vaultwarden
[Service]
Type=oneshot
ExecStart=/usr/local/bin/vw-backup
# /etc/systemd/system/vw-backup.timer
[Unit]
Description=Sauvegarde Vaultwarden chaque nuit
[Timer]
OnCalendar=*-*-* 03:15
RandomizedDelaySec=15m
Persistent=true
[Install]
WantedBy=timers.target
sudo systemctl daemon-reload
sudo systemctl enable --now vw-backup.timer
Avec 51 entrées et une pièce jointe, l'archive pèse 240 Ko et se fait en moins d'une
seconde. Nous l'avons restaurée : conteneur arrêté, dossier data vidé,
archive décompressée, conteneur relancé. Un client neuf a retrouvé les 51 entrées et
la pièce jointe, identique à l'octet près (même SHA-256). Une copie qui reste sur la
même machine ne protège pas d'une perte de la machine : envoyez l'archive ailleurs
(rsync ou scp vers un autre serveur) et gardez les
sauvegardes de machine de la console comme deuxième filet.
11. Mettre à jour
Fixez une version précise dans compose.yml plutôt que
latest : vous choisissez le moment du changement. Vaultwarden publie
souvent, et la 1.37.5 du 1er novembre corrige deux failles. Lisez les
notes de version,
lancez une sauvegarde, changez l'étiquette, puis :
sudo vw-backup
cd /opt/vaultwarden
sudo docker compose pull
sudo docker compose up -d
Nous l'avons fait sur une instance de test passée de 1.37.4 à 1.37.5, une montée qui ajoute une migration de la base : l'entrée créée sous 1.37.4 était intacte après la mise à jour. Le retour en arrière n'est pas prévu une fois la migration appliquée ; c'est la sauvegarde qui sert de retour.
12. Ce que ça consomme
| Mesure sur la Nano | Valeur |
|---|---|
| Conteneur Vaultwarden, au repos | 9 à 12 Mio |
| Caddy | environ 47 Mio |
| fail2ban | environ 29 Mio |
| Docker (dockerd et containerd) | environ 180 Mio |
| Mémoire utilisée par tout le système | 431 Mio sur 1 974 |
| Données (51 entrées, une pièce jointe) | 1,9 Mo |
Docker pèse plus lourd que le gestionnaire de mots de passe. La Nano garde plus de 1,5 Gio disponible, assez pour une petite équipe ; nous n'avons pas mesuré de charge avec plusieurs dizaines d'utilisateurs simultanés.
13. Les limites
Vaultwarden suit Bitwarden avec un temps de retard : une fonction nouvelle des clients peut demander une version récente du serveur, comme le rappellent les notes de la 1.37.5. Le soutien passe par la communauté, pas par un contrat. Sans serveur de courriel, ni invitations par message, ni vérification d'adresse, ni alertes de connexion. Et l'administrateur, c'est vous : mises à jour de Debian, de Docker et de Vaultwarden, sauvegardes hors de la machine, surveillance. Notre guide pour sécuriser un VPS couvre le reste de la machine. Activez aussi la double authentification dans chaque compte ; nous ne l'avons pas testée pour cet article.