PassZit

PassZit downloaden

Elke link verwijst naar de nieuwste release op GitHub. Releases zijn ondertekend; de server werkt zichzelf bij vanuit dezelfde releases.

Kies hoe u de server installeert

ManierIdeaal voorVereist
1. Kant-en-klare VM-imageImporteren, starten, aanmelden — Debian, PostgreSQL en PassZit staan klaarVMware, VirtualBox, Proxmox/KVM of Hyper-V
2. Appliance-ISOEen nieuwe VM of fysieke server, zonder tussenkomstInternettoegang tijdens de installatie
3. InstallatiescriptEen bestaande Debian-, Ubuntu-, AlmaLinux- of Rocky Linux-serverRoot- en internettoegang
4. Pakketten handmatigEigen PostgreSQL, configuratiebeheerHet 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

OVA

VMware ESXi, Workstation, VirtualBox

passzit-appliance.ova

ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vSphere: Deploy OVF Template.

QC

Proxmox VE en KVM

passzit-appliance.qcow2

Maak een VM zonder schijf (2 vCPU, 2 GB RAM, VirtIO-netwerk), importeer de schijf en koppel die als SCSI-opstartschijf.

VHD

Hyper-V (generatie 1)

passzit-appliance-vhdx.zip

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:

BestandWat
passzit-server_X_amd64.deb, _arm64.deb, .rpmDe server, voor handmatige installatie (x86-64 en ARM64)
passzit-extension-chromium-X.zip, -firefox-X.zipDe 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, -arm64Opent externe verbindingen vanuit de extensie op Linux; op Windows doet de MaxZit Launcher dat (download hem op de pagina Launcher van uw server)
SHA256SUMSControlesommen van de programma's en pakketten
SHA256SUMS-applianceControlesommen 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:

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.