Bitwarden est un gestionnaire de mots de passe et de clés d’accès open source qui utilise le chiffrement à connaissance nulle et le chiffrement de bout en bout pour protéger tes données. Tu peux l’utiliser comme service cloud ou l’héberger toi-même. Il propose des fonctionnalités pour générer, stocker et remplir automatiquement des identifiants robustes.
Tu veux héberger ce service toi-même ? Nous allons te guider pas à pas dans sa configuration et son installation, et te présenter tous les points à prendre en compte.
Avant d’installer Bitwarden, vérifie que ton environnement d’hébergement répond aux exigences suivantes afin de garantir une installation sans problème et des performances optimales.
| Matériel | Minimum | Recommandation de ZAP-Hosting |
|---|---|---|
| CPU | 1 cœur vCPU | 4 cœurs vCPU |
| RAM | 2 GB | 4 GB |
| Espace disque | 12 GB | 25 GB |
Le logiciel nécessite l’installation de toutes les dépendances requises et doit fonctionner sur un système d’exploitation pris en charge. Avant de commencer l’installation, vérifie que ton serveur répond aux exigences suivantes :
Dépendances : Docker (Engine 26+ und Compose)
Système d’exploitation : dernière version de Windows Server prenant en charge Docker 26+
Vérifie que toutes les dépendances sont installées et que tu utilises la bonne version du système d’exploitation afin d’éviter les problèmes de compatibilité lors de l’installation de Bitwarden.
Avant de configurer Bitwarden, tu dois préparer ton système. Cela comprend la mise à jour de ton système d’exploitation et l’installation de toutes les dépendances nécessaires. Cette préparation garantit un environnement stable et aide à éviter les problèmes pendant ou après l’installation.
Pour que ton système dispose des dernières mises à jour logicielles et de sécurité, commence toujours par effectuer une mise à jour. Tu auras ainsi les derniers correctifs de sécurité et les versions les plus récentes des logiciels avant de continuer.
Une fois la mise à jour terminée, tu peux commencer à installer les dépendances. Bitwarden est fourni et exécuté sur ton système dans plusieurs conteneurs Docker. Docker doit donc d’abord être installé. Pour cela, installe Docker Desktop sur ton serveur.
Tu trouveras des instructions détaillées pour installer et utiliser Docker dans notre guide Docker.
Nous te recommandons de configurer ton serveur Windows avec un compte de service dédié bitwarden, qui servira à installer et exécuter Bitwarden. Tu veilleras ainsi à ce que ton instance Bitwarden fonctionne de manière isolée des autres applications de ton serveur.
Ouvre PowerShell en tant qu’administrateur. Crée l’utilisateur local Bitwarden à l’aide des commandes suivantes. Une fenêtre de saisie de texte s’affichera après la première commande. Saisis le mot de passe de ton choix et confirme-le. Exécute ensuite la deuxième commande pour terminer la configuration.
PS C:\> $Password = Read-Host -AsSecureString
New-LocalUser "Bitwarden" -Password $Password -Description "Bitwarden Local Admin"
Crée ensuite un dossier Bitwarden sous C:\ pour le nouvel utilisateur :
PS C:\> mkdir Bitwarden
Dans Docker Desktop, ouvre Paramètres → Ressources → Partage de fichiers. Ajoute le chemin C:\Bitwarden aux répertoires partagés. Sélectionne « Appliquer et redémarrer » pour activer les modifications.
Par défaut, Bitwarden utilise les ports 80 (HTTP) et 443 (HTTPS) sur l’hôte. Configure un domaine avec des enregistrements DNS qui pointent vers ton hôte, par exemple server.example.com. C’est particulièrement important si tu rends Bitwarden accessible sur Internet. Évite d’inclure Bitwarden dans le nom d’hôte afin de ne pas révéler inutilement le rôle ou le logiciel du serveur.
Une fois tous les prérequis remplis et les préparatifs terminés, tu peux commencer l’installation de Bitwarden.
Télécharge le script d’installation de Bitwarden sur ton serveur et exécute-le :
cd C:\Bitwarden
Invoke-RestMethod -OutFile bitwarden.ps1 -Uri "https://func.bitwarden.com/api/dl/?app=self-host&platform=windows"
.\bitwarden.ps1 -install
Dans le programme d’installation, saisis d’abord le nom de domaine de ton instance Bitwarden, généralement l’enregistrement DNS configuré. Choisis ensuite si Let’s Encrypt doit générer un certificat SSL gratuit et fiable. Si oui, indique une adresse e-mail pour recevoir les notifications d’expiration. Si non, le programme te posera des questions sur le certificat.
Saisis ton ID d’installation et ta clé d’installation, que tu as obtenus auprès de Bitwarden. Choisis ensuite la région US ou EU. Ce choix est pertinent uniquement si tu associes une instance auto-hébergée à un abonnement payant.
Si tu n’utilises pas Let’s Encrypt, tu peux utiliser un certificat existant en plaçant les fichiers dans C:\Bitwarden\bwdata\ssl\<ta_domain> et en indiquant s’il est fiable. Tu peux aussi générer un certificat autosigné, mais cette option est recommandée uniquement pour les tests. Si tu n’utilises aucun certificat, tu dois placer un proxy HTTPS devant l’installation, sinon les applications Bitwarden ne fonctionneront pas.
Après l’installation, effectue la configuration de base à l’aide de deux fichiers. Commence par modifier le fichier d’environnement \bwdata\env\global.override.env. Renseigne les informations de ton serveur SMTP, notamment l’hôte, le port, SSL, le nom d’utilisateur et le mot de passe, afin que Bitwarden puisse envoyer des e-mails de vérification et d’invitation à des organisations. Si tu as besoin d’accéder au portail d’administration du système, ajoute une adresse e-mail d’administrateur à adminSettings__admins.
...
globalSettings__mail__smtp__host=<platzhalter>
globalSettings__mail__smtp__port=<platzhalter>
globalSettings__mail__smtp__ssl=<platzhalter>
globalSettings__mail__smtp__username=<platzhalter>
globalSettings__mail__smtp__password=<platzhalter>
...
adminSettings__admins=
...
Teste la configuration SMTP avec .\bitwarden.ps1 -checksmtp. Si elle est correcte, un message de réussite s’affichera. Sinon, tu recevras des indications concernant OpenSSL manquant ou des valeurs incorrectes. Applique les modifications avec .\bitwarden.ps1 -restart.
Vérifie ensuite les paramètres d’installation dans .\bwdata\config.yml. Ce fichier contrôle les ressources générées et doit être adapté aux environnements spécifiques, par exemple si tu utilises un proxy ou des ports alternatifs. Applique les modifications avec .\bitwarden.ps1 -rebuild.
Enfin, démarre l’instance avec .\bitwarden.ps1 -start. Le premier démarrage peut prendre un peu de temps, car Docker télécharge les images. Tu peux vérifier que tous les conteneurs sont en bon état avec docker ps. Ouvre ensuite le coffre-fort Web depuis le domaine configuré et crée un compte si nécessaire. La vérification de l’adresse e-mail ne fonctionnera que si les variables SMTP sont correctement configurées.
Félicitations ! Tu as installé et configuré Bitwarden avec succès sur ton Serveur VPS/serveur dédié. Nous te recommandons également de consulter les ressources suivantes, qui pourront t’aider à configurer ton serveur :
- bitwarden.com – Site officiel
- https://bitwarden.com/help/ – Centre d’aide Bitwarden (documentation)
Tu as des questions spécifiques auxquelles cet article ne répond pas ? Notre équipe d’assistance est à ta disposition tous les jours pour répondre à tes questions et t’aider. N’hésite pas à nous contacter ! 🙂