Kies hoe u de server installeert
| Manier | Ideaal voor | Vereist |
|---|---|---|
| 1. Kant-en-klare VM-image | Importeren, starten, aanmelden — Debian, PostgreSQL en PassZit staan klaar | VMware, VirtualBox, Proxmox/KVM of Hyper-V |
| 2. Appliance-ISO | Een nieuwe VM of fysieke server, zonder tussenkomst | Internettoegang tijdens de installatie |
| 3. Installatiescript | Een bestaande Debian-, Ubuntu-, AlmaLinux- of Rocky Linux-server | Root- en internettoegang |
| 4. Pakketten handmatig | Eigen PostgreSQL, configuratiebeheer | Het deb- of rpm-pakket van de release |
De server heeft 2 vCPU, 2 GB RAM en een schijf van 16 GB nodig. Browsers bereiken hem via TCP 8443. Voor de browserextensies heeft hij een naam en een certificaat nodig dat browsers vertrouwen — PassZit haalt er een bij Let's Encrypt of gebruikt het uwe (Instellingen → Certificaat).
1. Kant-en-klare VM-image
VMware ESXi, Workstation, VirtualBox
ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vSphere: Deploy OVF Template.
Proxmox VE en KVM
Maak een VM zonder schijf (2 vCPU, 2 GB RAM, VirtIO-netwerk), importeer de schijf en koppel die als SCSI-opstartschijf.
Hyper-V (generatie 1)
Uitpakken, een VM van generatie 1 met 2 GB RAM maken en de VHDX als schijf kiezen.
Op Proxmox VE, nadat de image naar de node is gekopieerd:
qm importdisk <vmid> passzit-appliance.qcow2 local-lvm
Start de VM: het scherm toont het consoleadres en een installatietoken. Open https://<adres>:8443, accepteer eenmalig het zelfondertekende certificaat, voer het token in en maak de eerste beheerder met tweestapsaanmelding aan. Meld u op het scherm van de VM aan als pzadmin (eerste wachtwoord passzit, wordt bij de eerste aanmelding gewijzigd): een menu stelt netwerk, servernaam en tijdzone in, toont het installatietoken en zet back-ups terug. Alleen de poorten 22 (SSH) en 8443 zijn open.
2. Appliance-ISO
passzit-appliance.iso — start een VM of server hiervan op. Na 5 seconden begint de onbeheerde installatie: die wist de eerste schijf, installeert Debian, PostgreSQL en PassZit via het netwerk en toont daarna het consoleadres en het installatietoken.
3. Installatiescript
Op Debian 12+, Ubuntu 22.04+, AlmaLinux of Rocky Linux 9+ (x86-64 of ARM64), als root:
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. Voer het opnieuw uit om bij te werken. Opties (met sh -s -- bij een pipe): --version X, --db postgres://…, --no-auto-updates (laat automatische beveiligingsupdates van het systeem uit), --source URL. Om het eerst te lezen:
curl -fsSLO https://github.com/Max-Zit/passzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Pakketten en andere bestanden
sudo apt install ./passzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./passzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Stel PASSZIT_DB in in /etc/passzit/server.env, daarna systemctl start passzit-server. Het installatietoken staat in /var/lib/passzit/setup-token.txt. Deze bestanden hebben de versie in hun naam en staan op de releasepagina:
| Bestand | Wat |
|---|---|
passzit-server_X_amd64.deb, _arm64.deb, .rpm | De server, voor handmatige installatie (x86-64 en ARM64) |
passzit-extension-chromium-X.zip, -firefox-X.zip | De browserextensie voor handmatige installatie (zie hieronder) |
passzit-cli-X-linux-amd64, -windows-amd64.exe, -darwin-arm64 … | De opdrachtregel passzit voor Linux, Windows en macOS |
passzit-helper-X-linux-amd64, -arm64 | Opent externe verbindingen vanuit de extensie op Linux; op Windows doet de MaxZit Launcher dat (download hem op de pagina Launcher van uw server) |
| SHA256SUMS | Controlesommen van de programma's en pakketten |
| SHA256SUMS-appliance | Controlesommen van de VM-images en de ISO |
Browserextensie
De extensie vult inloggegevens in en slaat ze op in Chrome, Edge, Opera, Brave, Vivaldi en Firefox. Installeer haar via de winkel van uw browser, die haar up-to-date houdt:
Chrome Web Store
Chrome, Brave, Opera en Vivaldi.
Firefox Add-ons
Firefox 128 of nieuwer.
Microsoft Edge Add-ons
Microsoft Edge.
Uw PassZit-server biedt hetzelfde: Browserextensies in het menu van de webkluis verwijst naar de winkel van uw browser en biedt de pakketten van de eigen versie voor handmatige installatie. Klik daarna op het PassZit-pictogram, voer het adres van uw server in en kies Verbinden met de webkluis — in de extensie wordt geen wachtwoord getypt.
Een download controleren
sha256sum -c SHA256SUMS --ignore-missing # programma's en pakketten
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA, QCOW2, VHDX-zip, ISO
De server en het installatiescript controleren het ondertekende releasemanifest voordat ze iets installeren; zie Beveiliging.
Bijwerken
Instellingen → Updates en server toont de draaiende en de nieuwste versie en installeert updates, optioneel automatisch op een gekozen tijdstip. Alleen releases die met de releasesleutel van PassZit zijn ondertekend, worden geïnstalleerd; de server maakt eerst een back-up van database en programma en zet ze terug als de nieuwe versie niet start. Het kanaal Testing biedt releasekandidaten voor een testserver. Instellingen → Back-up van de console bewaart versleutelde dagelijkse back-ups van de database, de geheime sleutel van de server en het certificaat voor herstel op een nieuwe machine.