Bitwarden is een open-source wachtwoordmanager voor wachtwoorden en passkeys die zero-knowledge en end-to-end encryptie gebruikt om je gegevens te beschermen. Je kunt het als cloudservice gebruiken of zelf hosten – met functies voor het genereren, opslaan en automatisch invullen van sterke inloggegevens.
Wil je deze service zelf hosten? We begeleiden je stap voor stap bij de installatie en configuratie en laten je alles zien wat je moet weten.
Voordat je Bitwarden installeert, zorg ervoor dat je hostingomgeving aan de volgende eisen voldoet voor een soepele installatie en optimale prestaties.
| Hardware | Minimum | ZAP-Hosting Aanbeveling |
|---|---|---|
| CPU | 1 vCPU-kern | 4 vCPU-kernen |
| RAM | 2 GB | 4 GB |
| Opslag | 12 GB | 25 GB |
De software vereist dat alle benodigde afhankelijkheden geïnstalleerd zijn en draait op een ondersteund besturingssysteem. Controleer dat je server aan deze eisen voldoet voordat je begint met installeren:
Afhankelijkheden: Docker (Engine 26+ en Compose)
Besturingssysteem: nieuwste versie van Ubuntu/Debian met Docker 26+ ondersteuning
Zorg dat alle afhankelijkheden geïnstalleerd zijn en dat je de juiste besturingssysteemversie gebruikt om compatibiliteitsproblemen bij de Bitwarden-installatie te voorkomen.
Voordat je Bitwarden installeert, moet je je systeem voorbereiden. Dit betekent dat je je besturingssysteem bijwerkt en alle benodigde afhankelijkheden installeert. Deze voorbereiding zorgt voor een stabiele omgeving en helpt problemen tijdens of na de installatie te voorkomen.
Om je systeem up-to-date te houden met de nieuwste software- en beveiligingsupdates, voer je eerst de volgende opdracht uit:
sudo apt update && sudo apt upgrade -y
Zo zorg je ervoor dat je systeem de nieuwste beveiligingspatches en softwareversies heeft voordat je verder gaat met de installatie.
Nadat de update is voltooid, kun je de afhankelijkheden installeren. Bitwarden draait via meerdere Docker-containers op je systeem. Docker moet eerst geïnstalleerd worden. Voer hiervoor de volgende opdrachten uit:
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
Een uitgebreide handleiding voor het installeren en gebruiken van Docker vind je in onze Docker gids.
Het is aan te raden om je Linux-server te configureren met een speciale bitwarden service-account van waaruit Bitwarden wordt geïnstalleerd en beheerd. Zo blijft je Bitwarden-instantie geïsoleerd van andere applicaties op je server.
Maak de Bitwarden-gebruiker aan en stel een sterk, uniek wachtwoord in voor deze account.
sudo adduser bitwarden
sudo passwd bitwarden
Maak de Docker-groep aan als die nog niet bestaat en voeg de Bitwarden-gebruiker toe aan deze groep:
sudo groupadd docker
sudo usermod -aG docker bitwarden
Maak de werkmap aan, stel de rechten in en geef eigendom aan bitwarden:
sudo mkdir /opt/bitwarden
sudo chmod -R 700 /opt/bitwarden
sudo chown -R bitwarden:bitwarden /opt/bitwarden
Standaard draait Bitwarden op de host via poorten 80 (HTTP) en 443 (HTTPS). Stel een domein in met DNS-records die naar de host verwijzen, bijvoorbeeld server.example.com, vooral als je de dienst via internet aanbiedt. Vermijd het gebruik van "bitwarden" in de hostnaam om de rol of software van de server niet onnodig prijs te geven.
Als aan alle vereisten is voldaan en de voorbereidingen zijn afgerond, kun je beginnen met de installatie van Bitwarden.
Download het Bitwarden-installatiescript naar je server en voer het uit. Er wordt een map ./bwdata aangemaakt relatief aan de locatie van bitwarden.sh.
curl -Lso bitwarden.sh "https://func.bitwarden.com/api/dl/?app=self-host&platform=linux" && chmod 700 bitwarden.sh
./bitwarden.sh install
In de installer voer je eerst de domeinnaam van je Bitwarden-instantie in, meestal de geconfigureerde DNS-record. Vervolgens kies je of Let’s Encrypt een gratis, vertrouwd SSL-certificaat moet genereren. Zo ja, geef je een e-mailadres op voor vervalmeldingen. Zo nee, volgen vragen over het certificaat.
Voer je installatie-ID en installatiesleutel in die je bij Bitwarden hebt ontvangen. Kies daarna de regio US of EU, wat alleen relevant is als je een zelfgehoste instantie met een betaald abonnement koppelt.
Als je geen Let’s Encrypt gebruikt, kun je een bestaand certificaat gebruiken door de bestanden in ./bwdata/ssl/your.domain te plaatsen en aan te geven of het vertrouwd is. Je kunt ook een zelfondertekend certificaat genereren, wat alleen voor testdoeleinden wordt aanbevolen. Zonder certificaat moet je een HTTPS-proxy voor de installatie plaatsen, anders werken Bitwarden-applicaties niet.
Na de installatie voer je de basisconfiguratie uit via twee bestanden. Bewerk eerst het omgevingsbestand onder ./bwdata/env/global.override.env. Vul hier je SMTP-servergegevens in, inclusief host, poort, SSL, gebruikersnaam en wachtwoord, zodat Bitwarden verificatie- en organisatie-uitnodigingsmails kan versturen. Als je toegang tot het systeembeheerportaal wilt, voeg dan een admin-e-mailadres toe aan adminSettings__admins.
...
globalSettings__mail__smtp__host=<plaatsvervanger>
globalSettings__mail__smtp__port=<plaatsvervanger>
globalSettings__mail__smtp__ssl=<plaatsvervanger>
globalSettings__mail__smtp__username=<plaatsvervanger>
globalSettings__mail__smtp__password=<plaatsvervanger>
...
adminSettings__admins=
...
Test de SMTP-configuratie met ./bitwarden.sh checksmtp. Een correcte configuratie geeft succesmelding; anders krijg je aanwijzingen over ontbrekende OpenSSL of verkeerde waarden. Pas wijzigingen toe met ./bitwarden.sh restart.
Controleer daarna de installatieparameters in ./bwdata/config.yml. Dit bestand regelt de gegenereerde assets en moet aangepast worden voor speciale omgevingen, bijvoorbeeld als je achter een proxy werkt of alternatieve poorten gebruikt. Pas wijzigingen toe met ./bitwarden.sh rebuild.
Start de instantie ten slotte met ./bitwarden.sh start. De eerste start kan even duren terwijl Docker de images downloadt. Met docker ps controleer je of alle containers gezond zijn. Open daarna de webvault via je geconfigureerde domein en registreer indien nodig een account. E-mailverificatie werkt alleen met correct ingestelde SMTP-variabelen.
Gefeliciteerd! Je hebt Bitwarden nu succesvol geïnstalleerd en geconfigureerd op je VPS/Dedicated Server. We raden je aan ook de volgende bronnen te bekijken die je kunnen helpen bij serverconfiguratie:
- bitwarden.com – Officiële website
- https://bitwarden.com/help/ – Bitwarden Helpcentrum (documentatie)
Heb je specifieke vragen die hier niet beantwoord worden? Voor verdere vragen of ondersteuning staat ons team dagelijks voor je klaar – neem gerust contact op! 🙂