Aller au contenu

Bitwarden

Un coffre fort de mots de passes qu'on peut héberger soit-même.

La version auto-hébergée s'appelle Vaultwarden. Elle permet de garder la main sur les données (même chiffrées) et de bénéficier gratuitement des options payantes de bitwarden.

Ce guide détaille l'installation de Vaultwarden via Docker Compose, avec sécurisation de l'accès admin et script de sauvegarde automatisé.

1. Préparation de l'environnement

Créez le dossier de travail sur votre Raspberry Pi :

sudo mkdir -p /opt/dockers/vaultwarden
cd /opt/dockers/vaultwarden

2. Génération du Hash pour l'Admin Token

Pour ne pas laisser le mot de passe admin en clair, on utilise un hash Argon2. Lancez la commande suivante :

docker run --rm -it vaultwarden/server:latest /vaultwarden hash

Notez la chaîne de caractères obtenue (elle commence par $argon2id$...).

3. Configuration des fichiers

🔑 Fichier .env

Créez le fichier .env pour isoler les variables sensibles. Attention : Dans le fichier .env, on utilise des doubles symboles $$ pour éviter que Docker ne les interprète.

# /opt/dockers/vaultwarden/.env

VW_DOMAIN=https://votre-domaine.fr
VW_PORT=8080

# Hash Argon2 (Remplacez par le vôtre)
VW_ADMIN_HASH='$argon2id$v=19$m=65540,t=3,p=4$5jOFoqBsUco6rQAeFDxbPiCI/WUFk4LwF73pNRDhpmc$26ff/UHpaFS9FlrtsznoYuFrP4SrVnmQU2W4Ls5wa3s'

# Inscriptions (Passer à false une fois la famille inscrite)
VW_SIGNUPS_ALLOWED=true

🐳 Fichier docker-compose.yaml

Créez le fichier de déploiement :

# /opt/dockers/vaultwarden/docker-compose.yaml

services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    restart: always
    environment:

      - DOMAIN=${VW_DOMAIN}
      - SIGNUPS_ALLOWED=${VW_SIGNUPS_ALLOWED}
      - ADMIN_TOKEN=${VW_ADMIN_HASH}
    volumes:

      - ./vw-data:/data
    ports:

      - ${VW_PORT}:80

4. Lancement

Démarrez le conteneur :

sudo docker compose up -d

Accès aux interfaces :

  • Utilisateurs : http://VW_DOMAIN:8080
  • Administration : http://VW_DOMAIN:8080/admin

5. Sauvegarde automatisée

Pour éviter la corruption de la base de données SQLite, le script arrête brièvement le conteneur le temps de la copie.

💾 Le script de backup

Créez le fichier /nas/backup/scripts/vaultwarden.sh :

#!/bin/sh

# Configuration
basename="vaultwarden_data_"
ext="tar.gz"
fname="${basename}$(date +%Y-%m-%d_%Hh%M).${ext}"
sourcedir="/opt/dockers/vaultwarden/vw-data"
destdir="/nas/backup/primidi/croned/very_important"
tmpdir="/tmp/vw_backup_tmp"

# 1. Nettoyage et préparation
mkdir -p ${tmpdir}

# 2. Arrêt sécurisé du conteneur
docker stop vaultwarden

# 3. Copie des fichiers
cp -r ${sourcedir}/* ${tmpdir}/

# 4. Redémarrage immédiat
docker start vaultwarden

# 5. Compression (sans l'arborescence complète)
tar -zcvf /tmp/${fname} -C ${tmpdir} .

# 6. Ménage et rotation (garde 7 jours)
rm -rf ${tmpdir}
find ${destdir} -name "${basename}*.${ext}" -mtime +7 -delete
mv /tmp/${fname} ${destdir}

echo "Sauvegarde terminée : ${fname}"

⏰ Automatisation (Cron)

Rendez le script exécutable :

chmod +x /nas/backup/scripts/vaultwarden.sh

Ajoutez une tâche cron pour une exécution toutes les nuits à 3h00 :

0 3 * * * /nas/backup/scripts/vaultwarden.sh >> /var/log/vaultwarden_backup.log 2>&1

Composant Rôle
Vaultwarden Serveur de mots de passe (API Bitwarden)
Argon2 Méthode de hachage sécurisée pour le token admin
Docker Compose Orchestration du service
Cron / Script Sécurité des données et rotation des backups