PassZit

Installare un password manager self-hosted per il tuo team

Una guida passo passo da una macchina virtuale vuota a un team che compila gli accessi dal browser: installare PassZit, creare il primo amministratore, invitare i colleghi, collegare l’estensione del browser, portare con sé le vecchie password e mantenere il server con backup e aggiornato.

Di cosa tratta questa guida

PassZit è un password manager gratuito e open source (AGPLv3) che gira sul tuo server. Ogni utente ha una cassaforte cifrata end-to-end per accessi, codici monouso, note sicure, carte, chiavi SSH e file; i team condividono casseforti con permessi per persona. Il server conserva solo testo cifrato. Se stai confrontando strumenti perché hai cercato un’alternativa self-hosted a Bitwarden, questa guida mostra come si svolgono in pratica l’installazione e l’adozione di PassZit.

Cosa serve

  • Una macchina virtuale su VMware, VirtualBox, Proxmox VE/KVM o Hyper-V, o un server fisico, con 2 vCPU, 2 GB di RAM e un disco da 16 GB — oppure un server a 64 bit esistente con Debian 12+, Ubuntu 22.04+, AlmaLinux o Rocky Linux 9+ (x86-64 o ARM64).
  • I browser raggiungono il server sulla porta TCP 8443. PostgreSQL viene configurato dallo script di installazione e dalle immagini.
  • Per le estensioni del browser: un nome DNS per il server e un certificato di cui i browser si fidano (vedi sotto).
  • Facoltativamente un server SMTP, perché PassZit possa inviare inviti e avvisi per e-mail.

Installare il server

Ci sono quattro modi; sono tutti nella pagina di download e ogni release è firmata.

ModoIdeale per
Immagine VM: OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V generazione 1)Importa, avvia, accedi — Debian, PostgreSQL e PassZit sono pronti
ISO dell’applianceUna nuova VM o un server fisico; l’installazione automatica cancella il primo disco
Script di installazioneUn server Debian, Ubuntu, AlmaLinux o Rocky Linux esistente
Pacchetti (deb, rpm; amd64, arm64)Il tuo PostgreSQL e la tua gestione della configurazione

Immagine VM o ISO: avvia la VM. Il suo schermo mostra l’indirizzo della console e il token di configurazione. Sulla console della VM puoi accedere come pzadmin (prima password passzit, da cambiare al primo accesso): un menu imposta rete, nome del server e fuso orario, mostra di nuovo il token e ripristina i backup. Sono aperte solo le porte 22 (SSH) e 8443.

Script di installazione: come root sul server:

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

Lo script installa PostgreSQL, scarica la release più recente, ne verifica la firma, crea un database con una password casuale, avvia il servizio e stampa l’indirizzo e il token di configurazione. Opzioni come --version, --db (un database PostgreSQL esistente) o --no-auto-updates si passano con sh -s --.

Pacchetti: installa il deb o l’rpm, imposta PASSZIT_DB in /etc/passzit/server.env ed esegui systemctl start passzit-server. Il token di configurazione si trova in /var/lib/passzit/setup-token.txt.

Primo accesso e primo amministratore

  1. Apri https://<server>:8443. Un server nuovo usa un certificato autofirmato; il browser avvisa una volta — accettalo.
  2. Inserisci il Token di configurazione, il tuo indirizzo e-mail e una password principale. Il browser crea ora le tue chiavi; ci vuole un secondo. Questo primo account è l’amministratore.
  3. Scansiona il codice QR con un’app di autenticazione (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). L’accesso a due fattori è obbligatorio per ogni account. Conserva i dieci codici di recupero; ciascuno sostituisce l’app una volta.
  4. Crea una chiave di recupero (vedi sotto) e aggiungi il primo accesso con Nuovo elemento.

In seguito, in Il mio account, puoi aggiungere chiavi di sicurezza (YubiKey e altre) o una passkey del tuo dispositivo come secondo fattore.

Un certificato di cui i browser si fidano

Le estensioni del browser rifiutano i certificati autofirmati, quindi dai al server un certificato vero prima di distribuire l’estensione. In Impostazioni → Certificato carica un certificato (della CA aziendale o acquistato; PEM con i certificati intermedi e la chiave privata) oppure scegli Let's Encrypt. Let’s Encrypt richiede un nome DNS pubblico e lo verifica tramite la porta 80 del server o tramite un record DNS su Cloudflare — il secondo metodo funziona anche per un server raggiungibile solo nella tua rete. Il certificato viene usato subito, senza riavvio; il DNS della tua rete deve far puntare il nome al server.

Invitare il team

Gli account si creano solo su invito. In Utenti → Invita un utente inserisci l’indirizzo e-mail e il ruolo (Utente o Amministratore). PassZit mostra il link di invito una sola volta; invialo alla persona. Il link funziona una volta e per 7 giorni come impostazione predefinita. Se hai configurato un server SMTP in Impostazioni → E-mail, spunta Invia l'invito anche per e-mail e PassZit lo invia al posto tuo.

La persona invitata sceglie una password principale e configura l’accesso a due fattori, come hai fatto tu. Gli amministratori possono disattivare utenti, reimpostare un secondo fattore perso e ritirare inviti aperti. Per condividere le password, crea una cassaforte condivisa e dai accesso a persone o gruppi.

Gli account aziendali si collegano in Impostazioni → Accesso aziendale: single sign-on con OpenID Connect o SAML 2.0, e Active Directory / LDAP. La password principale resta sempre, perché è la chiave della cassaforte.

Password principale e chiave di recupero

La password principale non lascia mai il browser dell’utente. È il senso della crittografia end-to-end, e ha una conseguenza: nessuno — né l’amministratore né MaxZit — può aprire una cassaforte senza la password principale o la chiave di recupero. Gli amministratori non possono vedere né reimpostare le password principali.

  • Una passphrase di quattro-sei parole casuali è facile da ricordare e difficile da indovinare. I criteri della cassaforte fissano una lunghezza minima (12 caratteri come impostazione predefinita).
  • In Il mio account, Crea una chiave di recupero mostra una chiave di 32 lettere e cifre, una sola volta. Stampala o annotala e conservala offline — non nella cassaforte e non accanto al telefono.
  • Con la chiave di recupero e un codice dell’app di autenticazione, un utente che ha dimenticato la password principale ne imposta una nuova nella pagina di accesso. Senza chiave di recupero la cassaforte è persa; l’amministratore può solo eliminare l’account e invitare di nuovo la persona con una cassaforte vuota. L’elenco utenti mostra chi ha creato una chiave di recupero.

Chiedi a tutti di creare la chiave di recupero il primo giorno.

Installare l’estensione del browser

L’estensione compila accessi e codici monouso solo sul sito a cui appartengono, propone di salvare accessi nuovi e modificati, compila carte e indirizzi nei moduli di pagamento e di spedizione e genera password. 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

I link sono nella pagina di download. Il server PassZit offre lo stesso: Estensioni del browser nel menu della cassaforte web mostra Installa con un clic con lo store del browser che usi, oltre ai pacchetti della sua versione per l’installazione manuale.

  1. Fai clic sull’icona di PassZit, inserisci solo l’indirizzo del server (per esempio https://vault.example.com) e fai clic su Collega con la cassaforte web. Consenti al browser di lasciar comunicare PassZit con quel server. Una porta nell’indirizzo, come :8443, funziona in ogni browser, anche in Firefox.
  2. Si apre la cassaforte web; accedi lì se non l’hai già fatto.
  3. La cassaforte chiede se collegare l’estensione in questo browser — fai clic su Collega. Nell’estensione non si digita né password né codice.

La cassaforte web e l’estensione condividono un solo sblocco: sblocchi l’una e si apre anche l’altra, blocchi l’una e si bloccano entrambe.

Importare le password da un altro programma

Ogni utente importa nella propria cassaforte. Esporta prima dal vecchio programma, poi scegli Strumenti → Importa nella cassaforte e seleziona il file. PassZit riconosce il formato, mostra quanti elementi e cartelle ha trovato e quanti sono già nella cassaforte, e permette di mantenere le cartelle del file e saltare i duplicati.

DaEsportazione lì
Chrome, Edge, Brave, Opera, VivaldiPassword manager → Settings → Export passwords (CSV)
Firefoxabout:logins → … → Export passwords (CSV)
SafariFile → Export → Passwords (CSV)
BitwardenTools → Export vault → .json o .csv, non la variante cifrata
KeePass 2 / KeePassXCKeePass XML (2.x) / CSV o XML
1PasswordFile → Export → CSV
LastPassAdvanced options → Export (CSV)

Il file viene letto nel browser; il server riceve gli elementi solo cifrati. Vengono trasferiti accessi, note, siti web, campi personalizzati, cartelle, preferiti e segreti TOTP (da Bitwarden anche carte, identità e chiavi SSH). I file allegati non fanno parte di queste esportazioni. Elimina poi il file esportato — contiene le password in chiaro.

Come funziona la crittografia

Il browser deriva una chiave master dalla password principale con Argon2id (64 MiB, 3 passaggi). Da essa nascono due chiavi: una chiave di autenticazione inviata all’accesso — il server ne conserva solo un hash argon2id — e una chiave di wrapping che sblocca la chiave casuale dell’account dell’utente. Ogni elemento, compresi nome, nome utente, siti web e note, è cifrato con AES-256-GCM sotto la chiave della sua cassaforte; le casseforti condivise hanno una chiave propria, sigillata per la chiave X25519 di ogni membro. Il server vede testo cifrato, identificativi, dimensioni e orari, mai la password principale né una chiave che potrebbe usare. I dettagli sono nella pagina sulla sicurezza e in docs/ARCHITECTURE.md del repository.

Backup del server

Impostazioni → Backup della console scrive ogni giorno (e su richiesta con Backup ora) un backup in /var/lib/passzit/backups: il database con tutte le casseforti, la chiave segreta del server e il certificato della console — tutto ciò che serve a un nuovo server. Un backup è sempre cifrato con una passphrase che scegli tu; conservala altrove. Ogni backup può anche essere copiato in una cartella SFTP su un altro server. Per il ripristino usa il menu dell’appliance, oppure ferma il servizio ed esegui passzit-server -restore come descritto nella guida integrata nella console.

Aggiornamenti

Impostazioni → Aggiornamenti e server mostra la versione in esecuzione e quella più recente. L’installazione verifica di nuovo la firma, fa un backup del database e del programma, installa l’aggiornamento e controlla che il server ritorni — altrimenti rimette da sola la versione precedente e il database. Lì si attiva anche l’installazione automatica in un’ora scelta. Il canale Stabile riceve le release; Testing offre anche le release candidate, per un server di prova. In un’installazione con script, rieseguire lo script aggiorna anche PassZit e mantiene tutti i dati.

Limiti da conoscere

  • PassZit è in sviluppo attivo: la prima release pubblica è stata la 0.9.0 a novembre 2026, e nuove versioni escono spesso.
  • Non c’è un’app mobile nativa. Sul telefono la cassaforte web si può aggiungere alla schermata Home e si apre nella propria finestra, ma nulla viene conservato per l’uso offline — senza il server vedi una pagina «offline».
  • Una password principale dimenticata senza chiave di recupero non può essere recuperata da nessuno.
  • Le estensioni del browser richiedono un certificato attendibile e accedono con la password principale e il codice dell’app di autenticazione — non con il single sign-on.
  • Come per ogni cassaforte web, il suo JavaScript arriva dal server, quindi un server completamente compromesso potrebbe fornire codice modificato; l’estensione porta il proprio codice.
  • Non esiste un’immagine Docker; installa con un’immagine, lo script o i pacchetti. La guida integrata nella console è in inglese e serbo.

Prossimi passi

Scarica PassZit, guarda tutte le funzionalità — casseforti condivise, link segreti, accesso di emergenza, connessioni remote, la riga di comando — oppure leggi la guida integrata nella console (documentazione). Come impostare casseforti condivise per un team lo spiega la guida Condividere le password con il team. Le domande sono benvenute in GitHub Discussions. Le aziende possono ottenere supporto commerciale da MaxZit (solo in inglese).