PassZit

Scarica PassZit

Ogni link porta all'ultima release su GitHub. Le release sono firmate; il server si aggiorna dalle stesse release.

Scegli come installare il server

MetodoIdeale perRequisiti
1. Immagine VM prontaImporta, avvia, accedi — Debian, PostgreSQL e PassZit prontiVMware, VirtualBox, Proxmox/KVM o Hyper-V
2. ISO dell'applianceUna nuova VM o un server fisico, senza interventiAccesso a Internet durante l'installazione
3. Script di installazioneUn server Debian, Ubuntu, AlmaLinux o Rocky Linux esistenteAccesso root e a Internet
4. Pacchetti a manoPostgreSQL proprio, gestione della configurazioneIl pacchetto deb o rpm della release

Il server richiede 2 vCPU, 2 GB di RAM e un disco da 16 GB. I browser lo raggiungono su TCP 8443. Per le estensioni del browser servono un nome e un certificato attendibile per i browser — PassZit ne ottiene uno da Let's Encrypt o usa il tuo (Impostazioni → Certificato).

1. Immagine VM pronta

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 e KVM

passzit-appliance.qcow2

Crea una VM senza disco (2 vCPU, 2 GB di RAM, rete VirtIO), importa il disco e collegalo come disco di avvio SCSI.

VHD

Hyper-V (generazione 1)

passzit-appliance-vhdx.zip

Decomprimi, crea una VM di generazione 1 con 2 GB di RAM e scegli il VHDX come disco.

Su Proxmox VE, dopo aver copiato l'immagine sul nodo:

qm importdisk <vmid> passzit-appliance.qcow2 local-lvm

Avvia la VM: lo schermo mostra l'indirizzo della console e un token di configurazione. Apri https://<indirizzo>:8443, accetta una volta il certificato autofirmato, inserisci il token e crea il primo amministratore con accesso a due fattori. Sullo schermo della VM accedi come pzadmin (prima password passzit, da cambiare al primo accesso): un menu imposta rete, nome del server e fuso orario, mostra il token di configurazione e ripristina i backup. Sono aperte solo le porte 22 (SSH) e 8443.

2. ISO dell'appliance

passzit-appliance.iso — avvia da qui una VM o un server. Dopo 5 secondi parte l'installazione automatica: cancella il primo disco, installa Debian, PostgreSQL e PassZit dalla rete e poi mostra l'indirizzo della console e il token di configurazione.

3. Script di installazione

Su Debian 12+, Ubuntu 22.04+, AlmaLinux o Rocky Linux 9+ (x86-64 o ARM64), come root:

curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh

Lo script installa PostgreSQL, scarica l'ultima release, ne verifica la firma, crea un database con una password casuale, avvia il servizio e mostra l'indirizzo e il token di configurazione. Rieseguilo per aggiornare. Opzioni (con sh -s -- quando usi una pipe): --version X, --db postgres://…, --no-auto-updates (lascia disattivati gli aggiornamenti di sicurezza automatici del sistema), --source URL. Per leggerlo prima:

curl -fsSLO https://github.com/Max-Zit/passzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh

4. Pacchetti e altri file

sudo apt install ./passzit-server_X_amd64.deb      # Debian, Ubuntu
sudo dnf install ./passzit-server-X-1.x86_64.rpm   # AlmaLinux, Rocky Linux

Imposta PASSZIT_DB in /etc/passzit/server.env, poi systemctl start passzit-server. Il token di configurazione si trova in /var/lib/passzit/setup-token.txt. Questi file hanno la versione nel nome e sono elencati nella pagina della release:

FileCosa contiene
passzit-server_X_amd64.deb, _arm64.deb, .rpmIl server, per l'installazione a mano (x86-64 e ARM64)
passzit-extension-chromium-X.zip, -firefox-X.zipL'estensione del browser per l'installazione a mano (vedi sotto)
passzit-cli-X-linux-amd64, -windows-amd64.exe, -darwin-arm64 …La riga di comando passzit per Linux, Windows e macOS
passzit-helper-X-linux-amd64, -arm64Apre le connessioni remote dall'estensione su Linux; su Windows lo fa il MaxZit Launcher (scaricalo dalla pagina Launcher del tuo server)
SHA256SUMSChecksum dei programmi e dei pacchetti
SHA256SUMS-applianceChecksum delle immagini VM e dell'ISO

Estensione del browser

L'estensione compila e salva le credenziali in Chrome, Edge, Opera, Brave, Vivaldi e Firefox. Installala dallo store del tuo browser, che la mantiene aggiornata:

Il tuo server PassZit offre lo stesso: Estensioni del browser nel menu della cassaforte web rimanda allo store del tuo browser e offre i pacchetti della propria versione per l'installazione a mano. Poi fai clic sull'icona di PassZit, inserisci l'indirizzo del server e scegli Collega con la cassaforte web — nell'estensione non si digita alcuna password.

Verificare un download

sha256sum -c SHA256SUMS --ignore-missing             # programmi e pacchetti
sha256sum -c SHA256SUMS-appliance --ignore-missing   # OVA, QCOW2, zip VHDX, ISO

Il server e lo script di installazione verificano il manifest firmato della release prima di installare qualsiasi cosa; vedi Sicurezza.

Aggiornamenti

Impostazioni → Aggiornamenti e server mostra la versione in uso e quella più recente e installa gli aggiornamenti, facoltativamente in automatico a un'ora scelta. Vengono installate solo release firmate con la chiave di rilascio di PassZit; il server prima esegue il backup del database e del programma e li ripristina se la nuova versione non si avvia. Il canale Testing offre release candidate per un server di prova. Impostazioni → Backup della console conserva backup giornalieri cifrati del database, della chiave segreta del server e del certificato per il ripristino su una nuova macchina.