Waar deze handleiding over gaat
PassZit is een gratis open-source wachtwoordmanager (AGPLv3) die op uw eigen server draait. Elke gebruiker heeft een end-to-end versleutelde kluis voor aanmeldingen, eenmalige codes, beveiligde notities, kaarten, SSH-sleutels en bestanden; teams delen kluizen met rechten per persoon. De server bewaart alleen versleutelde gegevens. Vergelijkt u tools omdat u zocht naar een self-hosted alternatief voor Bitwarden, dan laat deze handleiding zien hoe installatie en uitrol van PassZit er in de praktijk uitzien.
- Wat u nodig hebt
- De server installeren
- Eerste aanmelding en eerste beheerder
- Een certificaat dat browsers vertrouwen
- Uw team uitnodigen
- Hoofdwachtwoord en herstelsleutel
- De browserextensie installeren
- Wachtwoorden uit een ander programma importeren
- Zo werkt de versleuteling
- Back-ups van de server
- Updates
- Beperkingen om te kennen
- Volgende stappen
Wat u nodig hebt
- Een virtuele machine op VMware, VirtualBox, Proxmox VE/KVM of Hyper-V, of een fysieke server, met 2 vCPU, 2 GB RAM en een schijf van 16 GB — of een bestaande 64-bit server met Debian 12+, Ubuntu 22.04+, AlmaLinux of Rocky Linux 9+ (x86-64 of ARM64).
- Browsers bereiken de server via TCP 8443. PostgreSQL wordt ingericht door het installatiescript en de images.
- Voor de browserextensies: een DNS-naam voor de server en een certificaat dat browsers vertrouwen (zie hieronder).
- Optioneel een SMTP-server, zodat PassZit uitnodigingen en meldingen per e-mail kan versturen.
De server installeren
Er zijn vier manieren; ze staan allemaal op de downloadpagina en elke release is ondertekend.
| Manier | Het best voor |
|---|---|
| VM-image: OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V generatie 1) | Importeren, starten, aanmelden — Debian, PostgreSQL en PassZit staan klaar |
| Appliance-ISO | Een nieuwe VM of een fysieke server; de automatische installatie wist de eerste schijf |
| Installatiescript | Een bestaande Debian-, Ubuntu-, AlmaLinux- of Rocky Linux-server |
| Pakketten (deb, rpm; amd64, arm64) | Eigen PostgreSQL en configuratiebeheer |
VM-image of ISO: start de VM. Het scherm toont het consoleadres en het installatietoken. Op de console van de VM kunt u zich aanmelden als pzadmin (eerste wachtwoord passzit, gewijzigd bij de eerste aanmelding): een menu stelt het netwerk, de servernaam en de tijdzone in, toont het token opnieuw en zet back-ups terug. Alleen de poorten 22 (SSH) en 8443 zijn open.
Installatiescript: als root op de server:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
Het script installeert PostgreSQL, downloadt de nieuwste release, controleert de handtekening, maakt een database met een willekeurig wachtwoord, start de dienst en toont het adres en het installatietoken. Opties zoals --version, --db (een bestaande PostgreSQL-database) of --no-auto-updates geeft u door met sh -s --.
Pakketten: installeer het deb- of rpm-pakket, stel PASSZIT_DB in /etc/passzit/server.env in en voer systemctl start passzit-server uit. Het installatietoken staat in /var/lib/passzit/setup-token.txt.
Eerste aanmelding en eerste beheerder
- Open
https://<server>:8443. Een nieuwe server gebruikt een zelfondertekend certificaat; de browser waarschuwt één keer — accepteer het. - Voer het Installatietoken, uw e-mailadres en een hoofdwachtwoord in. Uw browser maakt nu uw sleutels; dat duurt een seconde. Dit eerste account is de beheerder.
- Scan de QR-code met een authenticator-app (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). Tweestapsaanmelding is verplicht voor elk account. Bewaar de tien herstelcodes; elke code vervangt de app één keer.
- Maak een herstelsleutel (zie hieronder) en voeg uw eerste aanmelding toe met Nieuw item.
Later kunt u onder Mijn account beveiligingssleutels (YubiKey en andere) of een passkey van uw apparaat als tweede factor toevoegen.
Een certificaat dat browsers vertrouwen
De browserextensies weigeren zelfondertekende certificaten; geef de server dus een echt certificaat voordat u de extensie uitrolt. Onder Instellingen → Certificaat uploadt u een certificaat (van de CA van uw bedrijf of gekocht; PEM met de tussencertificaten en de privésleutel) of kiest u Let's Encrypt. Let’s Encrypt heeft een openbare DNS-naam nodig en controleert die via poort 80 van de server of via een DNS-record bij Cloudflare — dat laatste werkt ook voor een server die alleen in uw netwerk bereikbaar is. Het certificaat wordt meteen gebruikt, zonder herstart; de DNS van uw netwerk moet de naam naar de server laten wijzen.
Uw team uitnodigen
Accounts ontstaan alleen via een uitnodiging. Onder Gebruikers → Gebruiker uitnodigen voert u het e-mailadres en de rol in (Gebruiker of Beheerder). PassZit toont de uitnodigingslink één keer; stuur hem naar de persoon. De link werkt één keer en standaard 7 dagen. Hebt u onder Instellingen → E-mail een SMTP-server ingesteld, vink dan Uitnodiging ook per e-mail versturen aan en PassZit verstuurt hem voor u.
De uitgenodigde persoon kiest een hoofdwachtwoord en stelt tweestapsaanmelding in, net als u. Beheerders kunnen gebruikers uitschakelen, een verloren tweede factor resetten en openstaande uitnodigingen intrekken. Om wachtwoorden te delen maakt u een gedeelde kluis en geeft u personen of groepen toegang.
Bedrijfsaccounts koppelt u onder Instellingen → Bedrijfsaanmelding: single sign-on met OpenID Connect of SAML 2.0, en Active Directory / LDAP. Het hoofdwachtwoord blijft altijd, want dat is de sleutel van de kluis.
Hoofdwachtwoord en herstelsleutel
Het hoofdwachtwoord verlaat nooit de browser van de gebruiker. Dat is het doel van end-to-end versleuteling, en het heeft een gevolg: niemand — niet de beheerder, niet MaxZit — kan een kluis openen zonder het hoofdwachtwoord of de herstelsleutel. Beheerders kunnen hoofdwachtwoorden niet zien of resetten.
- Een wachtwoordzin van vier tot zes willekeurige woorden is makkelijk te onthouden en moeilijk te raden. Het kluisbeleid bepaalt een minimale lengte (standaard 12 tekens).
- Onder Mijn account toont Herstelsleutel maken een sleutel van 32 letters en cijfers, maar één keer. Druk hem af of schrijf hem op en bewaar hem offline — niet in de kluis en niet naast uw telefoon.
- Met de herstelsleutel en een code van de authenticator-app stelt een gebruiker die zijn hoofdwachtwoord vergeten is op de aanmeldpagina een nieuw in. Zonder herstelsleutel is de kluis verloren; de beheerder kan alleen het account verwijderen en de persoon opnieuw uitnodigen met een lege kluis. De gebruikerslijst laat zien wie een herstelsleutel heeft gemaakt.
Vraag iedereen om op de eerste dag een herstelsleutel te maken.
De browserextensie installeren
De extensie vult aanmeldingen en eenmalige codes alleen in op de site waar ze bij horen, biedt aan nieuwe en gewijzigde aanmeldingen op te slaan, vult kaarten en adressen in betaal- en verzendformulieren in en maakt wachtwoorden. Installeer haar uit de store van uw browser, die haar bijwerkt:
- Chrome Web Store — Chrome, Brave, Opera en Vivaldi
- Firefox Add-ons — Firefox 128 of nieuwer
- Microsoft Edge Add-ons — Microsoft Edge
De links staan op de downloadpagina. De PassZit-server biedt hetzelfde: Browserextensies in het menu van de webkluis toont Met één klik installeren met de store van de browser die u gebruikt, en de pakketten van zijn eigen versie voor installatie met de hand.
- Klik op het PassZit-pictogram, voer alleen het adres van uw server in (bijvoorbeeld
https://vault.example.com) en klik op Verbinden met de webkluis. Sta de browser toe PassZit met die server te laten praten. Een poort in het adres, zoals:8443, werkt in elke browser, ook in Firefox. - De webkluis opent; meld u daar aan als u dat nog niet bent.
- De kluis vraagt of de extensie in deze browser verbonden moet worden — klik op Verbinden. In de extensie wordt geen wachtwoord of code getypt.
De webkluis en de extensie delen één ontgrendeling: ontgrendel de een en de ander gaat ook open, vergrendel de een en beide vergrendelen.
Wachtwoorden uit een ander programma importeren
Elke gebruiker importeert in zijn eigen kluis. Exporteer eerst uit het oude programma en kies dan in de kluis Hulpmiddelen → Importeren en het bestand. PassZit herkent het formaat, toont hoeveel items en mappen het vond en hoeveel er al in de kluis staan, en laat u de mappen van het bestand behouden en dubbele items overslaan.
| Uit | Daar exporteren |
|---|---|
| Chrome, Edge, Brave, Opera, Vivaldi | Password manager → Settings → Export passwords (CSV) |
| Firefox | about:logins → … → Export passwords (CSV) |
| Safari | File → Export → Passwords (CSV) |
| Bitwarden | Tools → Export vault → .json of .csv, niet de versleutelde variant |
| KeePass 2 / KeePassXC | KeePass XML (2.x) / CSV of XML |
| 1Password | File → Export → CSV |
| LastPass | Advanced options → Export (CSV) |
Het bestand wordt in de browser gelezen; de server krijgt de items alleen versleuteld. Overgenomen worden aanmeldingen, notities, websites, eigen velden, mappen, favorieten en TOTP-geheimen (uit Bitwarden ook kaarten, identiteiten en SSH-sleutels). Bijlagen maken geen deel uit van deze exports. Verwijder het exportbestand daarna — het bevat de wachtwoorden onversleuteld.
Zo werkt de versleuteling
De browser leidt met Argon2id (64 MiB, 3 passes) een hoofdsleutel af uit het hoofdwachtwoord. Daaruit ontstaan twee sleutels: een aanmeldsleutel die bij het aanmelden wordt verstuurd — de server bewaart er alleen een argon2id-hash van — en een wrap-sleutel die de willekeurige accountsleutel van de gebruiker ontgrendelt. Elk item, ook de naam, gebruikersnaam, websites en notities, wordt versleuteld met AES-256-GCM onder de sleutel van zijn kluis; gedeelde kluizen hebben een eigen sleutel, verzegeld voor de X25519-sleutel van elk lid. De server ziet versleutelde gegevens, id’s, groottes en tijdstempels, nooit het hoofdwachtwoord of een sleutel die hij zou kunnen gebruiken. Details staan op de beveiligingspagina en in docs/ARCHITECTURE.md van de repository.
Back-ups van de server
Instellingen → Back-up van de console schrijft elke dag (en op verzoek met Nu back-up maken) een back-up naar /var/lib/passzit/backups: de database met alle kluizen, de geheime sleutel van de server en het consolecertificaat — alles wat een nieuwe server nodig heeft. Een back-up is altijd versleuteld met een wachtwoordzin die u instelt; bewaar die ergens anders. Elke back-up kan ook naar een SFTP-map op een andere server worden gekopieerd. Terugzetten doet u via het menu van de appliance, of u stopt de dienst en voert passzit-server -restore uit zoals de handleiding in de console beschrijft.
Updates
Instellingen → Updates en server toont de draaiende en de nieuwste versie. De installatie controleert de handtekening opnieuw, maakt een back-up van database en programma, installeert de update en controleert of de server terugkomt — zo niet, dan zet ze zelf de oude versie en de database terug. Daar zet u ook automatische installatie op een gekozen uur aan. Het kanaal Stabiel krijgt releases; Testing biedt ook releasekandidaten, voor een testserver. Bij een installatie met het script werkt opnieuw uitvoeren van het script PassZit ook bij, met behoud van alle gegevens.
Beperkingen om te kennen
- PassZit is volop in ontwikkeling: de eerste openbare release was 0.9.0 in november 2026, en er verschijnen vaak nieuwe versies.
- Er is geen native mobiele app. Op telefoons kan de webkluis aan het startscherm worden toegevoegd en opent hij in een eigen venster, maar niets wordt offline bewaard — zonder de server ziet u een "offline"-pagina.
- Een vergeten hoofdwachtwoord zonder herstelsleutel kan door niemand worden hersteld.
- De browserextensies hebben een vertrouwd certificaat nodig en melden zich aan met hoofdwachtwoord en authenticatorcode — niet met single sign-on.
- Zoals bij elke webkluis komt het JavaScript van de webkluis van de server, dus een volledig gecompromitteerde server zou gewijzigde code kunnen leveren; de extensie brengt haar eigen code mee.
- Er is geen Docker-image; installeer met een image, het script of de pakketten. De handleiding in de console is in het Engels en Servisch.
Volgende stappen
Download PassZit, bekijk alle functies — gedeelde kluizen, geheime links, noodtoegang, externe verbindingen, de opdrachtregel — of lees de handleiding die in de console is ingebouwd (documentatie). Hoe u gedeelde kluizen voor een team inricht, staat in de handleiding Wachtwoorden delen met uw team. Vragen zijn welkom in GitHub Discussions. Bedrijven kunnen commerciële support van MaxZit krijgen (alleen in het Engels).