Scegli come installare il server
| Metodo | Ideale per | Requisiti |
|---|---|---|
| 1. Immagine VM pronta | Importa, avvia, accedi — Debian, PostgreSQL e PassZit pronti | VMware, VirtualBox, Proxmox/KVM o Hyper-V |
| 2. ISO dell'appliance | Una nuova VM o un server fisico, senza interventi | Accesso a Internet durante l'installazione |
| 3. Script di installazione | Un server Debian, Ubuntu, AlmaLinux o Rocky Linux esistente | Accesso root e a Internet |
| 4. Pacchetti a mano | PostgreSQL proprio, gestione della configurazione | Il 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
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 e KVM
Crea una VM senza disco (2 vCPU, 2 GB di RAM, rete VirtIO), importa il disco e collegalo come disco di avvio SCSI.
Hyper-V (generazione 1)
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:
| File | Cosa contiene |
|---|---|
passzit-server_X_amd64.deb, _arm64.deb, .rpm | Il server, per l'installazione a mano (x86-64 e ARM64) |
passzit-extension-chromium-X.zip, -firefox-X.zip | L'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, -arm64 | Apre le connessioni remote dall'estensione su Linux; su Windows lo fa il MaxZit Launcher (scaricalo dalla pagina Launcher del tuo server) |
| SHA256SUMS | Checksum dei programmi e dei pacchetti |
| SHA256SUMS-appliance | Checksum 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:
Chrome Web Store
Chrome, Brave, Opera e Vivaldi.
Firefox Add-ons
Firefox 128 o successivo.
Microsoft Edge Add-ons
Microsoft Edge.
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.