Stalwart: server mail completo su un VPS
Scopri cosa sostituisce il singolo binario Rust di Stalwart in Postfix e Dovecot, cosa non risolve e quando mailcow resta la scelta migliore.
In cosa Stalwart concentra tutto in un unico binario
Stalwart è un server di posta che si esegue su un unico VPS come singolo binario Rust. Dallo stesso processo gestisce SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV e WebDAV e include un filtro antispam integrato, il proprio archivio dei messaggi e il proprio client ACME. Uno stack convenzionale svolge le stesse funzioni con Postfix, Dovecot, Rspamd, un database per gli account e uno strumento separato per i certificati. Stalwart sostituisce tutti questi componenti con una sola unità di servizio e un solo file di configurazione in /etc/stalwart/config.json.
Ogni dato, nome di impostazione e comando riportato di seguito proviene dalla documentazione, dalle pagine delle release e dallo script di installazione di Stalwart. Li abbiamo consultati per la prima volta il 28 August 2026 sulla release v0.16.19 (pubblicata il 24 August 2026) e li abbiamo verificati nuovamente il 12 October 2026, quando la release più recente era v0.16.26. Li abbiamo controllati ancora il 27 October 2026, il giorno dopo la pubblicazione di Stalwart v1.0.0 (26 October 2026). Abbiamo verificato nuovamente le fonti il 29 October 2026, quando la release più recente era v1.0.1, pubblicata il 28 October 2026. Abbiamo verificato nuovamente le fonti l'11 November 2026, quando la release più recente era v1.1.0, pubblicata il 9 November 2026. Questi sono comandi da eseguire sul proprio server. Ogni comando è seguito dal controllo che indica se è stato eseguito correttamente.
Stalwart è distribuito con doppia licenza: GNU Affero General Public License v3.0 (AGPL-3.0) e Stalwart Enterprise License v2. Alcune funzionalità sono disponibili solo nell'edizione enterprise. L'elenco documentato degli endpoint HTTP le contrassegna con /scim/v2/*. Leggere i termini di licenza prima di pianificare una distribuzione basata su una funzionalità che non è stata verificata personalmente.
Un unico binario riduce davvero il numero di componenti da gestire. Non riduce però i due fattori che determinano se i messaggi arrivano a destinazione.
La porta 25 e la reputazione DNS non dipendono dal software utilizzato
La porta TCP 25 in uscita è il primo controllo. Molti provider VPS la bloccano per impostazione predefinita sui nuovi account. Con la porta 25 bloccata, il server non può consegnare direttamente i messaggi al server di posta di un altro destinatario. Verificatela prima di installare qualsiasi componente.
sudo apt update && sudo apt install -y netcat-openbsd
nc -vz -w 5 alt1.aspmx.l.google.com 25Un risultato corretto stampa Connection to alt1.aspmx.l.google.com ... 25 port [tcp/smtp] succeeded! in circa un secondo. Un blocco si manifesta in uno di due modi. Se i pacchetti vengono scartati a monte, nessuno invia un reset al server, quindi nc resta in attesa per tutti i cinque secondi e poi stampa nc: connect to alt1.aspmx.l.google.com port 25 (tcp) failed: Connection timed out. Se invece il firewall rifiuta i pacchetti, restituisce un errore ICMP (il rifiuto di netfilter invia port unreachable, salvo diversa configurazione, ad esempio administratively prohibited), quindi l'errore viene restituito immediatamente, in genere come Connection refused o No route to host. In entrambi i casi, aprite un ticket con il provider.
Se il provider non sblocca la porta, l'unica soluzione è usare un relay. Stalwart può inoltrare tutta la posta in uscita a uno smarthost tramite una route Relay, la cui porta predefinita è 25 ma può avere qualsiasi valore da 1 a 65535, con l'opzione implicitTls e i campi authUsername e authSecret per un relay autenticato sulla porta 465 o 587. La posta uscirà quindi con la reputazione del relay, non con la vostra.
Il secondo controllo riguarda il modo in cui le reti riceventi valutano il vostro indirizzo IP e il vostro dominio. Sono inclusi il reverse DNS dell'IP, SPF, DKIM, DMARC e la cronologia di invio del blocco di indirizzi a cui appartenete. Nella pagina di configurazione DNS di Stalwart, così come risultava il 28 agosto 2026, era indicato chiaramente dove viene svolto questo lavoro: i record di reverse DNS «sono in genere configurati dal provider di hosting, non da Stalwart». Stalwart può pubblicare e gestire gli altri record DNS tramite l'API di un provider DNS supportato, ma il reverse DNS e la reputazione dell'IP dipendono comunque dal provider.
Per questo motivo, questa pagina non ripete la configurazione di questi record. Abbiamo una guida specifica: Configurare una volta per tutte SPF, DKIM e DMARC per tutto ciò che invia posta. Se non avete ancora deciso se gestire direttamente la posta, iniziate da la nostra analisi onesta sull'utilità attuale della posta self-hosted. La scelta di Stalwart non modifica nessuno di questi fattori.
Requisiti di una piccola VPS per eseguire un mail server Stalwart
La pagina dei requisiti di sistema di Stalwart, consultata il 27 ottobre 2026, non fornisce più una cifra per utente. Indica che un server inattivo "rimane ben al di sotto" dei suoi limiti di memoria e che l'utilizzo della CPU dipende dal volume di posta e dagli accessi, non dal numero di account. L'hashing delle password è intenzionalmente lento, pertanto un server con molti accessi richiede più core. L'unico esempio di dimensionamento presente nella pagina riguarda un host con 2 GiB di RAM, dove i limiti predefiniti sommano circa 2.4 GiB. Tale totale include due riserve da 512 MiB per account molto grandi, che rimangono vuote se non ne sono presenti. Le FAQ aggiungono che non viene pubblicata alcuna cifra misurata di utenti per nodo.
Le connessioni sono limitate per listener, non per server. maxConnections imposta un valore predefinito di 8.192 su ogni listener che non possiede una configurazione propria, quindi il limite dei descrittori di file del processo deve coprire diverse volte tale valore. Lo script di installazione lo innalza a 65536. Un servizio avviato in altro modo ottiene spesso 1024, valore che la pagina definisce troppo basso per la produzione.
La pagina non indica una dimensione minima del disco. Il suo benchmark ha misurato circa 0.95 GB di disco per GB di posta su RocksDB, notando che gli allegati già compressi, come immagini e PDF, potrebbero richiederne di più. Dimensionare il disco in base alla posta che si prevede di conservare, aggiungendo margine per la compattazione dello store.
Tre percorsi in uscita devono essere funzionanti, altrimenti il server appare non operativo per motivi non legati alla posta. Il server scarica il bundle dell'interfaccia web all'avvio da https://github.com/stalwartlabs/webui/releases/download/v2/webui.zip. Raggiunge https://acme-v02.api.letsencrypt.org/directory per i certificati Let's Encrypt. Richiede DNS su porta UDP e TCP 53 per le ricerche dei record MX e di autenticazione, a meno che il resolver non sia impostato su DNS over HTTPS o TLS. Anche le regole del filtro antispam e le liste IP-to-ASN e dei paesi provengono da GitHub. Un firewall in uscita restrittivo che blocca il primo percorso genera un mail server attivo le cui pagine /admin e /account restituiscono un errore 404.
Installare una release fissata, non la versione «latest»
L'installer ufficiale è uno script shell. Leggilo prima di eseguirlo.
curl --proto '=https' --tlsv1.2 -sSf https://get.stalw.art/install.sh -o install.sh
less install.sh
sudo sh install.shLa lettura dello script il 27 October 2026 mostra esattamente cosa fa. Crea un account di servizio stalwart e le directory necessarie. Scarica quindi i file da https://github.com/stalwartlabs/stalwart/releases/latest/download. Il binario viene installato in /usr/local/bin/stalwart con modalità 0755. La configurazione viene salvata in /etc/stalwart/config.json, i dati in /var/lib/stalwart e i log in /var/log/stalwart; tutte e tre le directory hanno modalità 0750 e appartengono a stalwart. Un file di ambiente viene scritto in /etc/stalwart/stalwart.env con modalità 0640 e appartiene a root:stalwart. Lo script accetta un solo prefisso di installazione opzionale e un flag --fdb per la build di FoundationDB. Non accetta alcun argomento per la versione.
Quest'ultimo punto è importante. Lo script scarica sempre la release più recente. Due server configurati a una settimana di distanza eseguono la stessa release se nel frattempo non ne viene pubblicata una nuova. Il 26 October 2026 la release più recente è diventata v1.0.0 e ha modificato il layout del database. Le note di rilascio indicano che le installazioni v0.16.x esistenti «cannot be upgraded in place», mentre l'annuncio di v1.0 specifica che un server v1.0 non aprirà uno store creato da una versione precedente. All'interno della linea 1.x, la pagina di Stalwart dedicata agli aggiornamenti indica che rieseguire lo script di installazione «sostituisce il binario, mantiene config.json e il file di ambiente e riavvia il servizio»; le FAQ indicano inoltre di eseguire un backup degli store di dati e di config.json prima di ogni aggiornamento minor o major. La sola linea 0.16 ha pubblicato sette patch release tra il 24 August e l'11 October 2026, diverse delle quali includevano correzioni di sicurezza. Fissa quindi la release più recente e modifica il valore fissato solo intenzionalmente.
Quando aggiorni un'installazione 1.x esistente alla v1.1.0, riavviala una volta con STALWART_UPDATE_ROLE_PERMISSIONS=true per aggiungere i permessi introdotti dopo la v1.0.0, quindi rimuovi la variabile. L'aggiornamento dalla v1.0.0 o dalla v1.0.1 disabilita inoltre la cifratura per-account dei dati a riposo: seleziona nuovamente la chiave pubblica di ogni account per riabilitarla, altrimenti i nuovi messaggi resteranno non cifrati. Le chiavi registrate e i messaggi già cifrati non vengono modificati.
STALWART_TAG=v1.1.0
curl -fsSLO "https://github.com/stalwartlabs/stalwart/releases/download/${STALWART_TAG}/stalwart-x86_64-unknown-linux-gnu.tar.gz"
tar zxf stalwart-x86_64-unknown-linux-gnu.tar.gz
sudo systemctl stop stalwart
sudo install -m 0755 -o root -g root stalwart /usr/local/bin/stalwart
sudo systemctl start stalwart
systemctl is-active stalwartsystemctl is-active stalwart dovrebbe stampare active. In caso contrario, leggi journalctl -u stalwart -n 50. L'asset della release Linux include un bundle .sigstore.json corrispondente, quindi la firma del download può essere verificata prima dell'installazione.
Se il server esegue già una release 0.16, non sostituirla installando direttamente un binario 1.x. Aggiorna prima alla v0.16.27, quindi segui il percorso di migrazione descritto nella sezione seguente, dedicata all'importazione della posta esistente.
L'unità scritta dallo script viene eseguita come User=stalwart, imposta AmbientCapabilities=CAP_NET_BIND_SERVICE e imposta LimitNOFILE=65536. Questa capability consente a un account senza privilegi di eseguire il bind sulle porte 25, 443, 465 e 993. Se in seguito scrivi una tua unità e ometti quella riga, i listener sulle porte privilegiate non riescono a eseguire il bind; Stalwart ignora questi listener, avvia gli altri e registra un evento registry.build-error per ogni listener non avviato. Copia anche il limite dei file, per il motivo indicato nella sezione sui requisiti.
Dove viene visualizzata la prima password amministrativa
Stalwart si avvia in modalità bootstrap e scrive nel log del servizio un account temporaneo denominato admin, con una password casuale di 16 caratteri. A ogni avvio in modalità bootstrap stampa una nuova password, quindi è valido solo il blocco più recente.
sudo journalctl -u stalwart -n 200 | grep -A8 'bootstrap mode'La procedura guidata di configurazione è in ascolto su HTTP non crittografato sulla porta 8080. La pagina Docker di Stalwart specifica che non offre protezione contro i tentativi di indovinare la password, quindi non esporre questa porta. In un'installazione tramite script, blocca la porta TCP in ingresso 8080 nel firewall dell'host prima della configurazione; il solo tunnel SSH non chiude l'accesso pubblico. Crea invece un tunnel dal laptop tramite SSH:
ssh -N -L 8080:127.0.0.1:8080 you@your-vpsApri quindi http://127.0.0.1:8080/admin e accedi come admin usando la password riportata nel log. La procedura guidata richiede il nome host del server, il dominio di posta predefinito, TLS, lo storage, la directory degli account, la gestione dei log e quella del DNS. Con la directory interna, nell'ultima schermata mostra il nuovo amministratore, admin@<domain>, e una password casuale che il server non visualizza né registra nuovamente; salvala in quel momento. Al termine, riavvia il servizio e da quel momento usa https://<your-host>/admin.
Se la password è uscita dal log, impostane una fissa. /etc/stalwart/stalwart.env include voci commentate specifiche per questo scopo, tra cui STALWART_RECOVERY_ADMIN=admin:changeme, STALWART_RECOVERY_MODE=true e STALWART_RECOVERY_MODE_PORT (8080 per impostazione predefinita). Rimuovi i commenti, riavvia, accedi e commentale nuovamente. La pagina di Stalwart sulla messa in sicurezza del server avverte che una variabile dimenticata è "una credenziale permanente con accesso completo", quindi rimuovila dopo che un account amministrativo permanente ha effettuato l'accesso. La stessa pagina raccomanda di usare gli account amministrativi solo per l'amministrazione, non come caselle di posta nei client IMAP, JMAP o DAV.
In modalità bootstrap, Stalwart non avvia alcun servizio di posta e apre un solo listener HTTP non crittografato, sulla porta 8080 per impostazione predefinita. Dopo la configurazione e un riavvio, i listener normali si avviano sulle porte 25, 465, 993, 995, 4190, 443 e 8080. La porta 25 deve rimanere aperta per ricevere la posta, mentre la porta 443 è necessaria per la maggior parte dei client e per la verifica ACME predefinita. La documentazione indica di rimuovere la porta 995 quando nessun client usa POP3, la porta 4190 quando nessuno gestisce i filtri Sieve da un client ManageSieve e la porta 8080 al termine della configurazione, dopo aver verificato che HTTPS sulla porta 443 funzioni. Le porte 587, 143 e 110 non hanno alcun listener, a meno che non se ne crei uno.
Eseguirlo in Docker con un tag fissato
L’immagine documentata è stalwartlabs/stalwart, pubblicata anche come ghcr.io/stalwartlabs/stalwart. Il 29 ottobre 2026 Docker Hub riportava v1.0.1, v1.0 e v1, ciascuno con una variante -alpine. La pagina Docker di Stalwart raccomanda il tag della versione principale v1, che segue la versione 1.x più recente, e sconsiglia latest, perché una futura versione principale potrebbe richiedere una procedura di aggiornamento diversa. Fissa invece la versione patch, per lo stesso motivo indicato per il binario precedente.
services:
stalwart:
image: stalwartlabs/stalwart:v1.1.0
container_name: stalwart
init: true
restart: unless-stopped
ports:
- "25:25"
- "465:465"
- "993:993"
- "443:443"
- "127.0.0.1:8080:8080"
volumes:
- stalwart-etc:/etc/stalwart
- stalwart-data:/var/lib/stalwart
volumes:
stalwart-etc:
stalwart-data:Questo file contiene il comando documentato docker run scritto in formato Compose. Le porte POP3S e ManageSieve sono escluse e la porta di configurazione è associata a localhost, come avviene anche nel comando documentato. Avvia il servizio e leggi la stessa riga di bootstrap:
docker compose up -d
docker compose logs stalwart 2>&1 | grep -A8 'bootstrap mode'La pagina Docker documenta anche STALWART_RECOVERY_ADMIN=admin:<password> per impostare una password nota all’avvio. In Compose questa impostazione corrisponde alla chiave environment:, se preferisci questa soluzione alla lettura dei log. La pagina specifica che le variabili d’ambiente vengono fissate quando viene creato un container, quindi un semplice riavvio non applica una modifica. docker compose up -d ricrea il container quando cambia l’ambiente. Rimuovi la variabile dopo la configurazione.
L’elenco completo delle porte documentate e il motivo per cui questo file è più breve
La pagina Docker di Stalwart pubblica 25, 465, 993, 995, 4190 e 443 su tutte le interfacce, mentre pubblica 8080 soltanto sul loopback (127.0.0.1:8080:8080). Non pubblica 587, 143 o 110, che non hanno alcun listener finché un amministratore non ne crea uno. La pagina sulla messa in sicurezza del server indica di rimuovere il listener POP3S sulla porta 995 quando nessun client usa POP3, il listener ManageSieve sulla porta 4190 quando nessun utente gestisce i filtri Sieve da un client e il listener 8080 dopo aver completato la configurazione e verificato il funzionamento di HTTPS sulla porta 443. Riaggiungi soltanto le porte richieste dai client effettivamente utilizzati. Se un telefono richiede l’invio tramite STARTTLS, crea un listener sulla porta 587 e pubblicalo. Se gli utenti scrivono regole Sieve da un client desktop, pubblica la porta 4190.
Se Compose è una novità, la nostra guida a Docker Compose per un VPS illustra la struttura dei file e il modello dei volumi denominati utilizzato in questo caso. Un’avvertenza particolarmente importante per i server di posta: Docker pubblica le porte scrivendo regole proprie nel firewall, che vengono valutate prima di quelle di ufw. Di conseguenza, ufw deny 8080 non chiude una porta pubblicata da Compose. Con Docker Engine 28.0.0 o versioni successive e la configurazione predefinita della rete bridge, associare 127.0.0.1 nella mappatura delle porte limita l’accesso all’host Docker. Per questo il file precedente usa tale impostazione e il tunnel SSH continua a essere applicabile. Docker avverte che le versioni precedenti alla 28.0.0 consentono agli host dello stesso segmento di rete L2 di raggiungere le porte pubblicate su localhost. Aggiorna quindi Docker prima di fare affidamento su questa protezione.
TLS senza certbot e i relativi compromessi
Stalwart implementa ACME (automatic certificate management environment) in modo nativo, pertanto non richiede certbot né hook di rinnovo. La documentazione elenca quattro metodi di validazione. HTTP-01 risponde a una richiesta di sfida sulla porta 80. TLS-ALPN-01, il metodo predefinito, presenta un certificato appositamente creato sulla porta 443 utilizzando il protocollo ALPN specifico per ACME. DNS-01 pubblica record TXT temporanei ed è uno dei due metodi in grado di emettere certificati wildcard. DNS-PERSIST-01 utilizza record TXT di autorizzazione a lunga durata invece di scriverne uno nuovo a ogni rinnovo.
Il compromesso è che Stalwart richiede di gestire direttamente l'handshake TLS. TLS-ALPN-01 funziona completando l'handshake autonomamente, quindi non può avere successo se posizionato dietro un reverse proxy che termina il TLS per conto del server. Se nginx o Caddy occupano già la porta 443 sulla macchina, esistono tre soluzioni. La guida ufficiale di Stalwart per nginx esegue nginx come passthrough TCP, tramite listen 443; proxy_pass 127.0.0.1:10443; proxy_protocol on;, in modo che la connessione TLS raggiunga Stalwart senza modifiche. Questa configurazione inoltra ogni connessione sulla porta 443 a Stalwart ed è adatta a un server in cui nginx non gestisce altri servizi su quella porta. In alternativa, è possibile configurare Stalwart per utilizzare DNS-01 o HTTP-01, oppure assegnargli un indirizzo IP dedicato.
DANE e MTA-STS: impostazioni predefinite da conoscere
Entrambi vengono configurati per strategia TLS sull'oggetto MtaTlsStrategy, in Settings, MTA, Outbound, TLS Strategies nell'interfaccia web. Il campo dane è impostato per impostazione predefinita su optional: tenta la convalida DANE quando il destinatario pubblica record TLSA e, in caso contrario, ripiega sul normale STARTTLS. Impostandolo su require, la consegna procede solo quando è disponibile un record TLSA verificabile. Il campo mtaSts si comporta allo stesso modo e, per impostazione predefinita, è impostato su optional. I timeout correlati sono tlsTimeout (predefinito: 3 minuti) e mtaStsTimeout (predefinito: 5 minuti).
Sul lato inbound, Stalwart può pubblicare la propria policy MTA-STS all'indirizzo https://mta-sts.<domain>/.well-known/mta-sts.txt, che richiede la porta 443 aperta. Il singleton MtaSts contiene mode (predefinito: testing), maxAge (predefinito: 7 giorni) e mxHosts, che sostituisce gli host MX consentiti e, quando è vuoto, li ricava dalle impostazioni di sistema. Sono necessari due record DNS: un record CNAME mta-sts che punta all'host di posta e un record TXT _mta-sts contenente l'identificatore della policy.
dig +short TXT _mta-sts.example.org
curl -s https://mta-sts.example.org/.well-known/mta-sts.txtLa ricerca TXT dovrebbe restituire una stringa v=STSv1; id=... e curl dovrebbe restituire il corpo della policy. Se curl non restituisce nulla, la porta 443 è chiusa oppure il certificato per mta-sts.example.org non è mai stato emesso.
Lasciare mode su testing finché entrambi i controlli non hanno esito positivo. Una policy in modalità enforce con un certificato non valido impedisce agli altri server di consegnare i messaggi al tuo server; saranno gli utenti a segnalare il problema, non i log. Anche DANE presenta un rischio analogo: richiede zone con firma DNSSEC sia per il dominio di posta sia per i relativi host MX, e i record TLSA pubblicati manualmente devono restare sincronizzati con il certificato o la chiave a cui fanno riferimento. Stalwart aggiorna i record TLSA dopo il rinnovo quando è abilitata la gestione automatica del DNS e tlsa è incluso nel publishRecords del dominio; per impostazione predefinita è escluso. Per i record pubblicati manualmente, reuseKey evita di modificare il riferimento alla chiave pubblica a ogni rinnovo. In alternativa, è possibile indicare la CA emittente.
La cifratura dei dati inattivi non è una cifratura end-to-end
Questa è la funzionalità interpretata più spesso in modo errato. Di seguito è riportato esattamente quanto specificato dalla documentazione. La cifratura dei dati inattivi viene attivata per account. L'utente esporta la propria chiave pubblica dal client di posta, incolla la chiave OpenPGP con codifica ASCII armor oppure il certificato S/MIME con codifica PEM nel gestore degli account in /account, nella sezione Account, Public Keys, quindi seleziona la chiave nelle impostazioni di cifratura dell'account. Da quel momento il server cifra ogni messaggio in ingresso con quella chiave prima di archiviarlo, come messaggio OpenPGP/MIME o S/MIME. L'opzione atRestEnable a livello di server nel singleton Encryption è attiva per impostazione predefinita. Se è disattivata, non viene cifrato nulla, indipendentemente dalle impostazioni dell'account. L'impostazione encryptOnAppend per account è disattivata per impostazione predefinita. Estende la cifratura ai messaggi aggiunti tramite JMAP e IMAP. Quando è disattivata, questi messaggi non vengono mai cifrati. Nella versione v1.0.1, i messaggi JMAP che contengono $draft e le copie nella cartella Sent create dall'invio tramite JMAP restano non cifrati anche quando la cifratura degli append è attiva. Dalla versione v1.0.2, l'algoritmo viene scelto in base alla chiave dell'utente e la scelta del cifrario per account è stata rimossa.
Questa funzionalità protegge un'immagine disco sottratta, un backup sottratto e il contenuto dell'archivio letto da un operatore dopo la consegna. La chiave privata non viene mai inviata al server. Senza di essa, i corpi dei messaggi archiviati non sono leggibili e nemmeno l'amministratore può decifrarli.
La funzionalità non protegge il messaggio durante il transito. Un messaggio attraversa Internet usando il livello TLS concordato dai due server, arriva in testo normale e Stalwart lo cifra in quel momento. Il mittente, il provider del mittente e qualsiasi hop che abbia rimosso TLS hanno già potuto leggere il testo normale.
È opportuno dichiarare esplicitamente altri quattro limiti. Alla data dell'11 novembre 2026, la documentazione li indica tutti. Le cartelle Sent e Drafts vengono scritte dal client dell'utente tramite un'operazione di append e l'impostazione encryptOnAppend per account è disattivata per impostazione predefinita. Le bozze JMAP e le copie nella cartella Sent create dall'invio tramite JMAP restano non cifrate anche quando l'impostazione è attiva. La cifratura copre soltanto il corpo e gli allegati. Header come From, To, Subject e Date restano in testo normale e non modifica l'envelope né i log di consegna. La cifratura «non è retroattiva in nessuna delle due direzioni». La posta archiviata prima della registrazione di una chiave resta leggibile e la disattivazione della cifratura non decifra i contenuti archiviati mentre era attiva. Inoltre, una ricerca nel corpo o negli allegati di un messaggio cifrato non restituisce risultati, né tramite JMAP né tramite IMAP. Le ricerche per mittente, destinatario o oggetto continuano invece a funzionare.
L'addestramento antispam può lasciare una copia separata in testo normale. L'impostazione allowSpamTraining per account, disattivata per impostazione predefinita, consente di creare campioni prima della cifratura. L'apprendimento automatico a livello di server può invece conservare campioni indipendentemente dalle impostazioni di cifratura dell'account.
Se un utente perde la propria chiave privata, la posta non è più recuperabile. Per progettazione, non esiste alcun meccanismo di recupero.
Dalla versione v1.0.3, Stalwart offre anche una cifratura separata dei blob, con chiavi simmetriche conservate dal server. Questa funzionalità protegge il backend di archiviazione dei blob, ma il server può decifrarli. Non offre quindi la stessa protezione contro la lettura della posta archiviata da parte di un amministratore.
WKD è un compito per web server, non per mail server
WKD (Web Key Directory) rappresenta l'altra metà del sistema OpenPGP e risolve un problema differente. Pubblica la tua chiave pubblica a un URL HTTPS fisso sotto il tuo dominio, in modo che il client di posta del mittente possa trovarla e cifrare il messaggio prima ancora che lasci la sua macchina. Questa è la cifratura end-to-end. La cifratura at-rest di Stalwart riguarda invece la copia presente sul tuo disco. Configurare una non fornisce l'altra.
Stalwart non gestisce WKD. I suoi endpoint HTTP documentati, letti il 27 ottobre 2026, elencano percorsi ben noti per jmap, caldav, carddav, oauth-authorization-server, openid-configuration, oauth-protected-resource, user-agent-configuration.json, autoconfig, mail-v1.xml, mta-sts.txt e acme-challenge. Non esiste alcun percorso openpgpkey. Servilo tramite un comune web server statico.
La specifica definisce due layout. Il metodo avanzato utilizza https://openpgpkey.example.org/.well-known/openpgpkey/example.org/hu/iy9q119eutrkn8s1mk4r39qejnbu3n5q?l=Joe.Doe. Il metodo diretto utilizza https://example.org/.well-known/openpgpkey/hu/iy9q119eutrkn8s1mk4r39qejnbu3n5q?l=Joe.Doe. Quella stringa di 32 caratteri è l'hash SHA-1 della parte locale (in minuscolo) codificata in z-base-32; ecco perché questi nomi di file non vanno mai creati manualmente. GnuPG li genera per te.
gpg --export --armor you@example.org > you.asc
gpg-wks-client --print-wkd-url you@example.org
gpg-wks-client --install-key you.asc you@example.org--print-wkd-url stampa l'URL che un client recupererà, utilizzando il formato con sottodominio. --install-key scrive la chiave in un albero di directory locale che rispecchia il layout WKD, sotto una directory di primo livello chiamata per impostazione predefinita openpgpkey e modificabile con -C dir. Copia quell'albero nella tua web root, aggiungi il file richiesto policy accanto alla directory hu (un file vuoto è valido) e recupera il tuo URL con curl per confermare che restituisca i byte della chiave e non un errore 404.
Archiviazione su un singolo VPS
Stalwart separa l’archiviazione in quattro ruoli: un data store per i record strutturati, come account, struttura delle mailbox e impostazioni; un blob store per i byte grezzi dei messaggi e gli allegati; un search store per l’indice full-text; e un in-memory store per i dati a breve durata, come contatori di rate limiting, voci di greylisting, lock e token. Ogni ruolo può usare un backend diverso. L’elenco dei backend supportati comprende RocksDB, FoundationDB, PostgreSQL, MySQL e MariaDB, SQLite, il filesystem, l’object storage compatibile con S3, Azure Blob Storage, Redis, ElasticSearch e Meilisearch.
Su un singolo VPS, la risposta è semplice. La documentazione definisce RocksDB “the default and recommended data store for single-node installations” e la guida agli store indica che usare RocksDB lasciando tutti gli altri store ai valori predefiniti è la configurazione più semplice per un singolo server. Redis “cannot serve as the data store, the blob store or the search store”. Redis viene usato come in-memory store, coordinatore del cluster o livello di cache, quindi per iniziare non è necessario alcun container Redis separato. In seguito puoi spostare il blob store su S3 se le mailbox superano lo spazio disponibile sul disco.
I backup dipendono dal backend. La FAQ, consultata il 27 ottobre 2026, indica che il server non esegue backup autonomamente, che copiare i file di un data store in esecuzione non costituisce un backup e che l’esportazione integrata è un dump offline di un server arrestato, destinato a trasferire i dati tra backend. Esegui il backup di ogni store usando gli strumenti specifici del relativo backend. Con RocksDB su un singolo server, la guida agli store indica che tutti i dati risiedono in un’unica directory, ovvero /var/lib/stalwart in un’installazione tramite script. Copia questa directory a servizio arrestato oppure da uno snapshot del filesystem o del volume, e includi una copia di config.json e del file dell’ambiente. Una copia a livello di file di un key-value store in esecuzione può acquisire dati durante una scrittura; potresti accorgertene soltanto quando tenterai di ripristinarli.
Il filtro antispam che sostituisce Rspamd
Il filtraggio viene eseguito all'interno dello stesso processo, pertanto non è necessario mantenere attivo un secondo demone. Il classificatore si configura sul singleton SpamClassifier in Impostazioni, Filtro antispam, Classificatore. Utilizza l'algoritmo FTRL-Proximal con feature hashing. FtrlFh è il modello predefinito. FtrlCcfh sostituisce il sistema con un cuckoo feature hashing ed è pensato per i server in cui le collisioni di hash limitano l'accuratezza del classificatore, a fronte di un maggiore consumo di memoria e di elaborazione per messaggio. Il sistema apprende dai messaggi che gli utenti contrassegnano come spam o come posta legittima; un nuovo classificatore necessita di almeno 100 campioni di spam e 100 di ham prima del primo addestramento. Il classificatore antispam basato su AI, che esegue modelli di intelligenza artificiale, è una funzionalità Enterprise.
Attorno al classificatore sono presenti le blocklist DNS, il greylisting, il rilevamento di phishing, gli spam trap e Pyzor, oltre all'opzione per richiamare SpamAssassin tramite milter, qualora si disponga di regole a cui non si vuole rinunciare.
Quando mailcow resta la scelta giusta
Stalwart non include una webmail. Questa è la lacuna principale e non è prossima a essere colmata. La documentazione di mailcow, consultata il 12 ottobre 2026, elenca sedici componenti, tra cui SOGo, che offre agli utenti una casella accessibile dal browser e un'interfaccia CalDAV e CardDAV pronta all'uso. Il post della roadmap di Stalwart del 20 giugno 2025 afferma che una webmail dedicata è prevista, ma «non è attualmente la nostra priorità immediata». Dovrebbe essere realizzata in Rust con Dioxus dopo il raggiungimento della versione 1.0, «molto probabilmente nel corso del 2026». La versione 1.0 è stata rilasciata il 26 ottobre 2026, ma né le note di rilascio né l'annuncio fanno riferimento alla webmail. Al 27 ottobre 2026, il blog del progetto non contiene alcun post che ne annunci una. Con Stalwart devi quindi distribuire Roundcube autonomamente oppure chiedere a ogni utente di configurare un client di posta.
Stalwart dispone comunque di un'interfaccia di amministrazione web, quindi questa non è la lacuna che ci si aspetta. La seconda lacuna riguarda la novità della linea stabile. Stalwart è rimasto nelle versioni 0.x fino alla pubblicazione di v1.0.0, il 26 ottobre 2026. La FAQ ora afferma che «la versione 1.0 è una release stabile» e l'annuncio dichiara che lo schema è stabile e che le versioni future potranno essere aggiornate direttamente. Al momento di questa verifica, questa promessa ha sedici giorni e ogni server 0.16 deve essere migrato, non aggiornato, per raggiungere la versione 1.0.
La terza lacuna è quella che nessuno inserisce in un elenco di funzionalità. Postfix, Dovecot e Rspamd hanno alle spalle un decennio di risposte documentate. Alle due di notte, con i messaggi in coda e gli utenti in attesa, una ricerca che restituisce una stringa di errore corrispondente vale più di un'architettura elegante. Se questa è la tua situazione, la nostra guida all'installazione di mailcow descrive l'intero stack dall'inizio alla fine e la notte sarà più breve.
Scegli Stalwart se vuoi un unico binario, un solo file di configurazione e JMAP e sei disposto ad adottare una tecnologia ancora recente. Scegli mailcow se vuoi una webmail già disponibile e una vasta base di risposte esistenti.
Migrazione della posta esistente
Il percorso standard consiste nell'usare IMAP verso IMAP con imapsync, che non dipende dal software in esecuzione su nessuno dei due endpoint. Eseguire sempre una simulazione (dry run) iniziale.
imapsync --dry \
--host1 old.example.org --user1 you@example.org --passfile1 /root/.old.pw \
--host2 mail.example.org --user2 you@example.org --passfile2 /root/.new.pw--dry fa sì che imapsync "non esegua alcuna operazione reale, limitandosi a stampare ciò che verrebbe fatto"; leggere attentamente l'output prima di rimuovere il flag. Ogni file di password contiene la password sulla prima riga, quindi chmod 600 entrambi ed eliminarli al termine.
Stalwart rilascia inoltre strumenti più recenti che la maggior parte delle guide di terze parti non ha ancora integrato. Il blog ufficiale documenta Vandelay, un importatore ed esportatore JMAP (29 maggio 2026), e un proxy di migrazione per aggiornamenti a zero downtime (10 giugno 2026). Leggere entrambi prima di pianificare uno spostamento di grandi dimensioni, poiché sono più recenti di quasi tutto ciò che si trova scritto altrove.
Se il vecchio server è Stalwart 0.16, la documentazione ora fornisce due percorsi per passare alla versione 1.0. Lo strumento stalwart-migrate funziona solo dalla versione v0.16.27 e copia l'intera distribuzione in un nuovo archivio 1.0, con un downtime limitato a un'esecuzione finale mentre ogni nodo 0.16 è arrestato. Richiede spazio su disco sufficiente per una seconda copia dell'archivio dati. Il percorso account-per-account utilizza il proxy di migrazione, spostando gli account uno alla volta mentre entrambi i server sono attivi, al costo di dover riscaricare i dati degli account spostati sui client. La documentazione suggerisce stalwart-migrate per distribuzioni di piccole e medie dimensioni che possono accettare una breve finestra di manutenzione.
Modalità di errore e stringhe visualizzate
L'interfaccia di amministrazione non viene mai caricata. La pagina dei requisiti di Stalwart indica esplicitamente questa condizione: il bundle dell'interfaccia Web viene scaricato da GitHub all'avvio e, finché il download non riesce, /admin e /account restituiscono 404. Eseguire curl -sI https://github.com/stalwartlabs/webui/releases/download/v2/webui.zip dal server per verificare; un redirect indica che il controllo è superato, mentre un timeout indica un problema nel firewall per il traffico in uscita. La pagina di troubleshooting indica altre due cause. Dopo la configurazione, l'accesso funziona solo tramite HTTPS su /admin, mentre HTTP semplice restituisce Unknown client id. Se il server è dietro un reverse proxy o usa una porta HTTPS diversa da 443, deve essere configurato con l'URL utilizzato dai client.
La password di bootstrap non compare nei log. Viene stampata a ogni avvio mentre il server è in modalità bootstrap, e solo il blocco più recente è valido. Ampliare l'intervallo con sudo journalctl -u stalwart --since today | grep -A8 'bootstrap mode'. Se la procedura guidata ricompare dopo essere stata completata, significa che manca il file di configurazione: ripristinarlo o rimontare il volume che lo contiene. Se si preferisce non dipendere dai log, impostare STALWART_RECOVERY_ADMIN in /etc/stalwart/stalwart.env e riavviare.
Le porte privilegiate non rispondono dopo aver creato un'unità personalizzata. Senza AmbientCapabilities=CAP_NET_BIND_SERVICE, l'utente stalwart non può mettersi in ascolto sulle porte 25, 443, 465 o 993. Stalwart ignora ogni listener che non riesce ad avviare, avvia gli altri e registra un evento registry.build-error con Failed to bind to <address>: <error>. Copiare la riga relativa alle capability dall'unità generata dall'installer. Se un altro server di posta occupa la porta 25, arrestarlo e disabilitarlo. L'unità dell'installer è in conflitto con Postfix, Sendmail ed Exim; avviarne uno arresta Stalwart.
I certificati non vengono mai emessi. HTTP-01 richiede che la porta 80 sia raggiungibile e inoltrata a un listener HTTP di Stalwart. TLS-ALPN-01 richiede che sia Stalwart a rispondere all'handshake TLS sulla porta 443. Se un altro processo occupa la porta richiesta senza inoltrare la challenge, ACME fallisce e registra eventi acme.auth-error o acme.order-invalid. Con DNS manuale, la pagina di troubleshooting richiede inoltre che mta-sts, autoconfig, autodiscover e ua-auto-config, nel dominio predefinito, risolvano all'indirizzo del server, perché vengono inclusi nel certificato. Gli errori di rete, DNS e convalida vengono ritentati automaticamente secondo la policy di retry dell'attività; le richieste non valide e le challenge non supportate non vengono ritentate.
FAQ
Stalwart sostituisce Postfix, Dovecot e Rspamd su un unico VPS?
Sì. Un singolo binario Rust gestisce SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV e WebDAV e include il filtro antispam, l'archivio dei messaggi e un client ACME. È presente una sola unità systemd e un solo file di configurazione in /etc/stalwart/config.json, invece di quattro demoni e del relativo collegamento. Non sostituisce la zona DNS né la policy del provider sulla porta 25, che determinano il successo o il fallimento della posta self-hosted.
Quanta RAM richiede un server di posta Stalwart?
Al 27 ottobre 2026, la pagina dei requisiti di sistema di Stalwart non indica una quantità per utente e la FAQ specifica che non è stato pubblicato alcun dato misurato sul numero di utenti per nodo. La pagina afferma che un server inattivo resta ben al di sotto dei propri limiti e che l'uso della CPU dipende dal volume della posta e dagli accessi, non dal numero di account. L'unico esempio completo riguarda un host da 2 GiB, in cui i limiti di memoria predefiniti ammontano a circa 2.4 GiB, incluse due riserve da 512 MiB che restano vuote, salvo che il server ospiti account molto grandi. maxConnections ha come valore predefinito 8,192 per listener. Non è pubblicata una dimensione minima del disco, quindi dimensiona il disco in base alla posta che conserverai.
Passare a Stalwart migliorerà la deliverability della posta?
No. La deliverability dipende dal fatto che la porta TCP 25 in uscita sia aperta sul VPS, dal reverse DNS dell'indirizzo IP e dai record SPF, DKIM e DMARC del dominio. Stalwart supporta DANE, MTA-STS e i report TLS SMTP e può pubblicare la policy MTA-STS, ma questi meccanismi regolano la sicurezza del trasporto, non il livello di fiducia che una rete ricevente accorda al tuo indirizzo. Verifica la porta 25 con nc -vz -w 5 alt1.aspmx.l.google.com 25 prima di installare qualsiasi componente.
Stalwart include la webmail?
Non al 27 ottobre 2026. Include un'interfaccia web di amministrazione, che è un componente diverso. Il post della roadmap del progetto, datato 20 giugno 2025, afferma che lo sviluppo della webmail sarebbe iniziato dopo il raggiungimento della versione 1.0, con un'implementazione in Rust e Dioxus, "molto probabilmente nel corso del 2026". La versione 1.0 è stata rilasciata il 26 ottobre 2026 senza webmail e il blog del progetto non contiene ancora alcun annuncio al riguardo. Se gli utenti hanno bisogno subito di una casella accessibile dal browser, installa Roundcube insieme a Stalwart oppure usa uno stack che includa SOGo.
Da cosa protegge la cifratura dei dati a riposo di Stalwart?
Cifra i messaggi in arrivo di ogni utente che ha attivato la funzione con la relativa chiave pubblica OpenPGP o S/MIME prima di scriverli sul disco. In questo modo, chi sottrae un disco o un backup, oppure un amministratore che legge l'archivio, non può recuperare i corpi dei messaggi. Non si tratta di cifratura end-to-end: il messaggio arriva in testo in chiaro e viene cifrato al momento della consegna, quindi tutti gli hop precedenti possono leggerlo. L'impostazione encryptOnAppend per account è disattivata per impostazione predefinita, quindi i messaggi aggiunti dal client restano in chiaro, a meno che il server consenta la cifratura dei dati a riposo e l'account abiliti la cifratura dei messaggi aggiunti; anche in questo caso, nella v1.0.1 le bozze JMAP e le copie nella cartella Sent create dall'invio JMAP restano non cifrate. La documentazione specifica che gli header, come mittente, destinatari e oggetto, restano leggibili, che la posta archiviata prima della registrazione della chiave non viene cifrata nuovamente e che le ricerche nel corpo e negli allegati non restituiscono risultati per i messaggi cifrati. L'addestramento antispam può conservare campioni separati in testo in chiaro prima della cifratura.