Comment Installer Bitwarden avec Docker

Bitwarden est un gestionnaire de mots de passe gratuit et open source qui stocke les informations sensibles dans un coffre-fort chiffré. Il est développé en C# à l’aide de .NET Core et ASP.NET Core, et sa base de données repose sur T-SQL/SQL Server.

Bitwarden est un service cloud accessible via plusieurs applications clientes, ce qui le rend multiplateforme : via le web, des applications de bureau (Windows, macOS, Linux), des applications mobiles, des extensions de navigateur (Chrome, Firefox, Safari, Edge, Opera, Vivaldi, Brave, Tor), ou encore via l’interface en ligne de commande (CLI).

L’une des principales raisons d’utiliser Bitwarden est d’éviter les gestionnaires de mots de passe tiers, où les données sont stockées sur des serveurs externes. En le déployant sur votre propre serveur sécurisé, vous gardez un contrôle total sur vos informations.

Bitwarden repose sur un ensemble de conteneurs Docker, chacun contenant un composant fonctionnel distinct — comme la base de données ou le serveur web. Ainsi, l’installation et l’exécution de Bitwarden nécessitent un système de conteneurisation, en l’occurrence Docker.

Principales fonctionnalités de Bitwarden

Copier le lien

• Open source

• Chiffrement des données via AES 256 bits

• Prise en charge de l’authentification à deux facteurs (2FA)

• Système d’audit et de vérification des mots de passe

• Prise en charge de l’authentification biométrique

• Possibilité d’héberger le serveur localement

• Applications clientes multiplateformes sur tous les systèmes courants

Prérequis

Copier le lien

Ce guide utilise des commandes pour les systèmes de type UNIX, notamment Debian/Ubuntu, fréquemment utilisés pour le déploiement d’applications serveur.

Avant d’installer et de configurer Bitwarden, assurez-vous que tous les paquets système sont à jour :

sudo apt update

sudo apt upgrade

Si votre serveur est neuf, installez quelques outils de base :

sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

Ensuite, assurez-vous que Docker et Docker Compose sont installés pour gérer les conteneurs Bitwarden.

Étape 1 : Installer Docker et ses composants

Copier le lien

Ajoutez la clé GPG officielle de Docker, utilisée pour signer les paquets :

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Ajoutez ensuite le dépôt Docker pour obtenir la dernière version disponible :

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Mettez à jour le système :

sudo apt update

Enfin, installez Docker et Docker Compose :

sudo apt install docker-ce docker-ce-cli containerd.io docker-compose

Étape 2 : Sécuriser l’installation de Bitwarden

Copier le lien

Pour renforcer la sécurité, créez un utilisateur dédié avec des permissions limitées.

Créez le répertoire de Bitwarden :

sudo mkdir /opt/bitwarden

Créez l’utilisateur :

sudo adduser bitwarden

Attribuez les droits d’accès au répertoire :

sudo chmod -R 700 /opt/bitwarden

sudo chown -R bitwarden:bitwarden /opt/bitwarden

Autorisez l’utilisateur Bitwarden à exécuter des commandes Docker :

sudo usermod -aG docker bitwarden

Connectez-vous avec cet utilisateur :

su bitwarden

cd /opt/bitwarden

Étape 3 : Installer Bitwarden dans Docker et démarrer le serveur

Copier le lien

Même sans connaissance approfondie de Docker, les développeurs de Bitwarden ont prévu un script d’installation automatisé.

Téléchargez-le et rendez-le exécutable :

curl -Lso bitwarden.sh https://go.btwrdn.co/bw-sh && chmod 700 bitwarden.sh

Exécutez ensuite le script :

./bitwarden.sh install

Le script vous demandera plusieurs informations :

• Le nom de domaine du serveur Bitwarden

• Le nom de la base de données

• Si vous souhaitez utiliser Let’s Encrypt pour obtenir un certificat SSL gratuit

Vous devrez également fournir un ID d’installation et une clé, que vous pouvez générer sur le site officiel de Bitwarden.

Étape 4 : Configurer un serveur de messagerie SMTP

Copier le lien

Bien qu’optionnelle, la configuration d’un serveur SMTP est recommandée pour la gestion des connexions administratives. Modifiez le fichier ./bwdata/env/global.override.env et ajoutez-y les paramètres SMTP :

globalSettings__mail__smtp__host=smtp.gmail.com

globalSettings__mail__smtp__port=587

globalSettings__mail__smtp__ssl=true

globalSettings__mail__smtp__username=votre_email@gmail.com

globalSettings__mail__smtp__password=votre_mot_de_passe

adminSettings__admins=votre_email@gmail.com

Si vous maîtrisez Docker, vous pouvez utiliser un serveur mail conteneurisé, tel que docker-mailserver, particulièrement adapté à Bitwarden. Dans un scénario plus simple (mais moins sécurisé), vous pouvez également utiliser un service public comme Gmail :

globalSettings__mail__replyToEmail=votre_email@gmail.com

globalSettings__mail__smtp__host=smtp.gmail.com

globalSettings__mail__smtp__username=votre_email

globalSettings__mail__smtp__password=votre_mot_de_passe

globalSettings__mail__smtp__ssl=true

globalSettings__mail__smtp__port=587

globalSettings__mail__smtp__useDefaultCredentials=false

globalSettings__disableUserRegistration=true

Une fois configuré, Bitwarden enverra les notifications via votre compte Gmail. Assurez-vous d’activer l’option « autoriser les applications moins sécurisées » dans votre compte, sinon Google pourrait bloquer la connexion.

Si vous utilisez un autre fournisseur d’e-mails, renseignez ses paramètres SMTP (hôte, port, SSL, etc.) de manière similaire. En cas d’échec d’envoi, utilisez un outil de test SMTP en ligne pour vérifier et ajuster les paramètres.

Étape 5 : Démarrer le serveur et vérifier son fonctionnement

Copier le lien

Démarrez le serveur à l’aide du même script :

./bitwarden.sh start

Accédez ensuite à l’adresse IP ou au domaine du serveur depuis un navigateur. Pour ouvrir le panneau d’administration, ajoutez /admin à la fin de l’URL.

La page vous demandera l’adresse e-mail renseignée dans le fichier global.override.env. Le serveur SMTP enverra un lien d’accès sans mot de passe à ce courriel.

Vous pouvez ensuite utiliser les applications Bitwarden (desktop, mobile ou web) pour vous connecter à votre serveur et gérer vos mots de passe en toute sécurité.

Arrêter et supprimer le serveur

Copier le lien

En cas de dysfonctionnement ou si vous souhaitez réinstaller Bitwarden, arrêtez le service :

./bitwarden.sh stop

Supprimez le répertoire de données :

rm -r ~/bwdata

Puis réinstallez si nécessaire :

./bitwarden.sh install

Conclusion

Copier le lien

L’installation de Bitwarden est simple grâce au script automatisé fourni par ses développeurs. Une fois configuré, vous pouvez sécuriser vos données sensibles avec ce puissant gestionnaire de mots de passe, en utilisant DNS, SSL et SMTP selon vos besoins. Pour aller plus loin, consultez la documentation officielle de Bitwarden, qui regorge de conseils et bonnes pratiques.