Vaultwarden è un server open source compatibile con le app ufficiali di Bitwarden: estensione, app per smartphone e programma desktop si collegano a un container sul vostro mini PC, NAS o VPS. La versione stabile è la 1.37.5 del 1° novembre 2026: corregge due vulnerabilità e gli sviluppatori raccomandano di aggiornare il prima possibile. Questa guida segue il wiki del progetto, dalla cartella vuota al backup, con Docker Compose e Caddy.
In breve
- Tempo: 45–60 minuti.
- Difficoltà: media.
- Cosa serve: un server Linux con Docker e il plugin Compose, un nome di dominio che punta al server, le porte 80 e 443 raggiungibili da Internet.
- Risultato: un archivio di password in HTTPS sul vostro dominio, con registrazioni chiuse e backup.
Versioni: Vaultwarden 1.37.5 (1° novembre 2026, web vault incluso v2026.10.1), Caddy v2.11.9, Docker Compose v5.7.1. La procedura segue il wiki ufficiale di Vaultwarden e la pagina di aiuto di Bitwarden sui server self-hosted, verificati il 13 novembre 2026.
A chi serve, e che cosa non è
Serve a chi ha già una macchina con Docker sempre accesa e vuole le password di famiglia su un disco proprio, senza rinunciare alle app di Bitwarden.
Non è un prodotto di Bitwarden: le FAQ precisano che il progetto non è associato a Bitwarden Inc. Non gestisce istanze pubbliche e non ne avalla nessuna: l’unico Vaultwarden da usare è il vostro. I dati stanno in un database SQLite, la soluzione che il wiki consiglia alla maggior parte degli utenti.
Cosa serve prima di iniziare
Docker con il plugin Compose. Se manca, installatelo dal repository ufficiale come in Docker e Docker Compose su Ubuntu e Debian.
Un nome di dominio e l’HTTPS. La pagina «Enabling HTTPS» del wiki spiega che l’HTTPS è di fatto obbligatorio: il web vault usa API crittografiche che i browser offrono solo sulle connessioni sicure. La strada consigliata è un reverse proxy con certificati Let’s Encrypt, e Caddy li ottiene da solo.
Uno scenario. Sono tre:
- Dominio pubblico con Caddy. È il percorso di questa guida.
- Solo rete di casa o VPN. È la scelta più prudente. Il wiki la copre con la variante «Caddy with DNS challenge», che richiede una build di Caddy con il modulo DNS. Da fuori casa si entra con una VPN WireGuard o con le soluzioni per chi è dietro CGNAT.
- Reverse proxy già attivo. Il wiki offre un modello minimo: il solo servizio
vaultwarden, con la porta pubblicata come11001:80e la variabileDOMAINimpostata. Il proxy si configura come in reverse proxy con Nginx Proxy Manager e Caddy.
Attenzione: qui finiranno tutte le vostre password. Senza HTTPS le app di Bitwarden non funzionano a dovere, avvertono le FAQ. Non pubblicate mai su Internet la porta del container in chiaro: davanti ci va un reverse proxy con un certificato valido, e il wiki sconsiglia l’HTTPS integrato di Vaultwarden (ROCKET_TLS). Aggiornate: le app di Bitwarden si aggiornano da sole e, avverte il wiki, un server rimasto indietro può smettere di funzionare all’improvviso. Organizzate il backup prima di salvare la prima password.
Passo 1: creare la cartella e i due file
Create una cartella, per esempio vaultwarden, ed entrateci. Lì create il file compose.yaml con il modello della pagina «Using Docker Compose» del wiki:
services:
vaultwarden:
image: vaultwarden/server:latest
container_name: vaultwarden
restart: always
environment:
DOMAIN: "https://vaultwarden.example.com"
SIGNUPS_ALLOWED: "true"
volumes:
- ./vw-data:/data
caddy:
image: caddy:2
container_name: caddy
restart: always
ports:
- 80:80
- 443:443
- 443:443/udp
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- ./caddy-config:/config
- ./caddy-data:/data
environment:
DOMAIN: "https://vaultwarden.example.com"
EMAIL: "[email protected]"
LOG_FILE: "/data/access.log"Sostituite DOMAIN in entrambi i servizi con il vostro indirizzo, https:// compreso, ed EMAIL con la casella per la registrazione ACME. La porta 80 serve alla verifica HTTP-01 del certificato, la 443/udp a HTTP/3. La cartella vw-data conterrà tutti i dati.
Nella stessa cartella create il file Caddyfile, qui riportato senza i commenti. Il wiki precisa che non va modificato.
{$DOMAIN} {
log {
level INFO
output file {$LOG_FILE} {
roll_size 10MB
roll_keep 10
}
}
tls {$EMAIL}
encode zstd gzip
reverse_proxy vaultwarden:80 {
header_up X-Real-IP {remote_host}
}
}Verifica: la cartella contiene compose.yaml e Caddyfile, e il dominio punta già all’indirizzo pubblico del server.
Passo 2: avviare i container e leggere i log
docker compose up -d
docker compose logs -fIl primo comando crea e avvia i due container, in una rete privata dove l’unico servizio esposto è Caddy. Il secondo mostra i log: quelli di Vaultwarden si aprono con il riquadro Starting Vaultwarden e il numero di versione.
Verifica: aprite nel browser il vostro dominio in https://: deve comparire la pagina di accesso del web vault, senza avvisi sul certificato. Altrimenti controllate che il dominio punti al server e che la porta 80 sia raggiungibile.
Passo 3: creare l’account e chiudere le registrazioni
Nella pagina di accesso scegliete Create account («Crea account» con il browser in italiano) e registrate il vostro utente con una password principale lunga, mai usata altrove. Fate registrare adesso anche i familiari. Per impostazione predefinita chiunque raggiunga la pagina può creare un account. In compose.yaml, tra le variabili del servizio vaultwarden, sostituite la riga SIGNUPS_ALLOWED: "true" con queste due:
SIGNUPS_ALLOWED: "false"
INVITATIONS_ALLOWED: "false"La prima chiude le registrazioni. Da sola non basta: secondo il wiki chi amministra un’organizzazione può ancora invitare nuovi utenti, e la seconda lo impedisce. I suggerimenti per la password mostrati nella pagina web, che la «Hardening Guide» del wiki consiglia di spegnere, nella 1.37.5 sono già disattivati per impostazione predefinita (SHOW_PASSWORD_HINT): lasciateli così. Poi ricreate il container:
docker compose up -dUn riavvio non basta: le variabili sono legate al container, ricorda il wiki. Subito dopo attivate la verifica in due passaggi sul vostro account: senza, osserva ancora la «Hardening Guide», le password si possono in teoria tentare a forza bruta.
Verifica: in una finestra anonima il link Create account non deve più comparire.
Passo 4: la pagina di amministrazione (facoltativa)
Il pannello /admin mostra utenti e configurazione e permette di invitare qualcuno anche a registrazioni chiuse. Il wiki raccomanda di attivarlo solo dopo l’HTTPS. Con il dominio pubblico anche questa pagina è raggiungibile da Internet: se non vi serve, lasciatela spenta. Si accende con la variabile ADMIN_TOKEN, da proteggere con un hash Argon2 generato dal container:
docker exec -it vaultwarden /vaultwarden hashIl comando chiede due volte una password di almeno otto caratteri e stampa una riga ADMIN_TOKEN='…': vi serve la stringa tra gli apici, quella che inizia con $argon2id$. Copiatela senza apici tra le variabili del servizio raddoppiando tutti e cinque i simboli $, altrimenti Compose li scambia per variabili:
ADMIN_TOKEN: $$argon2id$$v=19$$m=…,t=…,p=…$$…$$…I puntini stanno per i valori della vostra stringa. Rilanciate docker compose up -d e controllate che cosa è arrivato al container:
docker exec vaultwarden printenv ADMIN_TOKENVerifica: l’output è la stringa originale, con i $ singoli e senza virgolette. All’indirizzo /admin del vostro dominio si entra con la password scelta, non con la stringa.
Al primo salvataggio dal pannello nasce il file config.json nella cartella dei dati: da quel momento i suoi valori prevalgono sulle variabili di compose.yaml. Per spegnere il pannello togliete ADMIN_TOKEN, cancellate l’eventuale chiave admin_token da config.json e ricreate il container.
Passo 5: collegare le app di Bitwarden
La pagina di aiuto di Bitwarden, in inglese, vale per estensione, app e programma desktop. Nella schermata di accesso aprite il menu del server, Logging in on o Accessing secondo l’app, scegliete Self-hosted, scrivete in Server URL l’indirizzo completo di https:// e confermate con Save. Con l’app in italiano i nomi possono cambiare.
Verifica: salvate una voce di prova dal telefono e sincronizzate l’estensione del browser: deve comparire anche lì.
Passo 6: il backup e la prova di ripristino
Dalla versione 1.32.1 Vaultwarden ha un comando integrato per il backup del database SQLite:
docker exec -it vaultwarden /vaultwarden backupLa copia nasce in vw-data, accanto al database, con un nome del tipo db_20261113_113400.sqlite3 (data e ora UTC): sta sullo stesso disco e va portata altrove. In alternativa il wiki indica il comando .backup di sqlite3, da installare sull’host perché l’immagine Docker non lo contiene. Il container gira come root, quindi sui suoi file può servire sudo. Dalla cartella del progetto, con una destinazione a vostra scelta:
sqlite3 vw-data/db.sqlite3 ".backup '/path/to/backups/db-$(date '+%Y%m%d-%H%M').sqlite3'"La pagina «Backing up your vault» elenca che cosa salvare dentro vw-data: obbligatori db.sqlite3 e la cartella attachments con gli allegati; consigliati config.json, che contiene dati sensibili in chiaro, e i file rsa_key*; facoltativa la cartella sends.
Il wiki consiglia almeno una copia remota, sconsiglia di affidarsi agli snapshot del filesystem e suggerisce di cifrare i backup. Tra gli strumenti adatti cita restic, che trattiamo in backup automatici con restic e regola 3-2-1.
Per il ripristino fermate Vaultwarden con docker compose down, sostituite i file dentro vw-data con le copie, rinominando quella del database in db.sqlite3, e cancellate l’eventuale db.sqlite3-wal rimasto, che secondo il wiki potrebbe corrompere il database. Poi ripartite con docker compose up -d.
Verifica: la destinazione contiene un file dal nome simile a db-20261113-1234.sqlite3. Provate il ripristino ogni tanto, come raccomanda il wiki.
Passo 7: aggiornare
docker compose pull
docker compose up -dIl tag latest segue l’ultima versione rilasciata ed è quello che il wiki consiglia; chi vuole decidere quando cambiare scrive un tag preciso, per esempio vaultwarden/server:1.37.5. Non esiste un calendario dei rilasci, dicono le FAQ: tenete d’occhio la pagina delle release su GitHub.
La 1.37.5 corregge un problema nelle icone dei siti (GHSA-x9cq-f669-vrr4, gravità media, 5.3) e uno nell’accesso di emergenza (GHSA-9pjj-f9g5-3x4c, gravità media, 4.3); i dettagli restano riservati in attesa dei CVE.
Verifica: riaprite il web vault. Con il pannello attivo, la pagina /admin/diagnostics segnala se esiste una versione più recente.
Se qualcosa va storto
The "argon2id" variable is not set. Defaulting to a blank string.
I simboli $ del token non sono stati raddoppiati. Lo stesso avviso compare per v e m. Il wiki lo riporta nella forma delle vecchie versioni di Compose, WARNING: The argon2id variable is not set.
You are using a plain text ADMIN_TOKEN which is insecure.
Per il wiki, o avete già salvato la configurazione dal pannello, e allora conta config.json, oppure la stringa è arrivata con virgolette attorno o con i $ ancora doppi. Il comando printenv del passo 4 lo mostra. Se invece in /admin si entra incollando l’intera stringa, la versione è troppo vecchia per Argon2.
Le app non si collegano o rifiutano il certificato
Di solito il certificato è autofirmato: le FAQ ricordano che alcune piattaforme non lo accettano e raccomandano Let’s Encrypt.
Il container non parte dopo l’aggiornamento alla 1.37.5
Da questa versione un valore di configurazione non valido ferma l’avvio. Le note di rilascio citano i numeri oltre 65535 per LOGIN_RATELIMIT_MAX_BURST o SMTP_TIMEOUT, oltre 255 per EMAIL_ATTEMPTS_LIMIT, e un DATABASE_MIN_CONNS superiore a DATABASE_MAX_CONNS. Controllate i file copiati da vecchie guide: l’errore si legge nei log.
Come tornare indietro
Il comando docker compose down ferma ed elimina i container; i dati restano in vw-data. La nostra indicazione: Vaultwarden regge bene il ruolo di archivio di famiglia, ma sposta su di voi tre compiti: certificato valido, aggiornamenti puntuali, backup provato. Chi non può garantirli fa meglio a restare nella rete di casa, dietro una VPN.
Fonti
- Vaultwarden (wiki, Using Docker Compose)
- Vaultwarden (note di rilascio 1.37.5)
- Vaultwarden (wiki, Enabling HTTPS)
- Vaultwarden (wiki, registrazioni)
- Vaultwarden (wiki, pagina di amministrazione)
- Vaultwarden (wiki, backup)
- Vaultwarden (wiki, aggiornamento)
- Vaultwarden (wiki, immagini e tag)
- Vaultwarden (wiki, configurazione)
- Vaultwarden (wiki, Hardening Guide)
- Vaultwarden (FAQ)
- Bitwarden (aiuto, collegare i client a un server self-hosted)
Immagine di copertina: Old key and laptop.jpg di User:Nikowsk, licenza CC BY-SA 4.0, via Wikimedia Commons; elaborazione grafica HardWarfare.
Articolo redatto con il supporto di strumenti di intelligenza artificiale e verificato dalla redazione. Come usiamo l'AI · Come lavoriamo
