Guida per sviluppatori

MailHog, Mailpit e Papercut SMTP: come testare le email in locale

Tre server SMTP di test che intercettano le email della tua applicazione senza inviarle a nessuno: cosa offre ciascuno, come installarlo, su quali porte ascolta e perché MailHog non è più la scelta consigliata.

Un server SMTP che accetta tutto e non consegna nulla

Quando costruisci un'applicazione che invia email (registrazioni, reimpostazioni password, ordini), devi vedere cosa parte senza che arrivi a nessuno. Un server SMTP di test accetta qualsiasi messaggio, lo conserva e te lo mostra in un'interfaccia, ma non lo consegna mai a un destinatario.

Così controlli oggetto, HTML, testo, intestazioni e allegati con i dati del tuo ambiente locale, senza il rischio di scrivere ai clienti e senza dipendere dalla connessione o dalle credenziali di un provider.

Risposta breve

Per un nuovo progetto usa Mailpit: funziona su Windows, Linux, macOS e Docker, ascolta sulla porta 1025 (SMTP) e 8025 (web) ed è mantenuto attivamente. MailHog usa le stesse porte, ma la sua ultima release è di agosto 2020 e non è più mantenuto. Papercut SMTP è l'alternativa se lavori su Windows e preferisci un'app desktop.

Confronto

I tre strumenti a colpo d'occhio

StrumentoCome installarloPorte predefiniteStato
MailpitBinario per Windows, Linux e macOS, Homebrew o l'immagine Docker axllent/mailpitSMTP 1025 · web 8025Mantenuto: versione 1.33.0, rilasciata il 31 ottobre 2026
MailHogBinario per Windows, Linux e macOS, Homebrew o l'immagine Docker mailhog/mailhogSMTP 1025 · web 8025Non mantenuto: l'ultima release, la 1.0.1, è dell'11 agosto 2020
Papercut SMTPInstaller per Windows (x64, x86 e ARM64), winget o l'immagine Docker changemakerstudiosus/papercut-smtpDesktop: SMTP 25 · Docker: SMTP 2525 e web 8080Mantenuto: versione 7.8.0, rilasciata il 15 agosto 2026

Versioni e date verificate il 2 novembre 2026 sulle pagine ufficiali di ogni progetto.

Mailpit

Mailpit: il sostituto abituale di MailHog

Mailpit si è ispirato a MailHog ed è diventato il suo sostituto abituale: fa lo stesso lavoro sulle stesse porte predefinite e continua a pubblicare nuove release. È un unico binario con licenza MIT.

Oltre a mostrare ogni email nel browser, include un'API REST per i test automatici, ricerca e tag, un controllo di compatibilità HTML con i client di posta, un verificatore di link e immagini e test antispam con SpamAssassin o Rspamd.

  1. 1Scarica il binario per il tuo sistema dalla pagina ufficiale delle release, installalo con brew install mailpit su macOS oppure avvia l'immagine Docker.
  2. 2Esegui mailpit. Per impostazione predefinita ascolta SMTP sulla porta 1025 e serve l'interfaccia web sulla 8025.
  3. 3Punta la tua applicazione all'host localhost, porta 1025, senza crittografia né autenticazione.
  4. 4Apri http://localhost:8025 e invia un'email di prova dalla tua applicazione.
docker run -d --restart unless-stopped --name=mailpit -p 8025:8025 -p 1025:1025 axllent/mailpit
MailHog

MailHog: perché non è più un buon punto di partenza

Per anni MailHog è stato lo strumento di riferimento per intercettare le email in sviluppo, e molti tutorial e vecchie configurazioni Docker lo usano ancora.

La sua ultima release, la 1.0.1, è uscita l'11 agosto 2020. Il README di Mailpit indica che MailHog non è più mantenuto e che sono passati anni senza sviluppo attivo né aggiornamenti di sicurezza.

Se lo usi già, passare a Mailpit è semplice: ascolta sulle stesse porte (1025 per SMTP e 8025 per il web), quindi la tua applicazione non ha bisogno di modifiche; basta sostituire il binario o l'immagine Docker.

Papercut SMTP

Papercut SMTP: l'opzione desktop per Windows

Papercut SMTP è un'app desktop per Windows che resta nell'area di notifica e ti avvisa quando arriva un'email. Mostra HTML, testo, intestazioni, parti MIME, allegati e sorgente grezzo di ogni messaggio.

Include un servizio in background opzionale con interfaccia web che riceve email anche quando l'app è chiusa, e un'immagine Docker per container e CI. L'app desktop ascolta su 127.0.0.1, porta 25, senza credenziali; l'immagine Docker usa la porta 2525 per SMTP e la 8080 per il web.

winget install ChangemakerStudios.Papercut-SMTP

La documentazione di Papercut avvisa che il pacchetto winget può essere in ritardo rispetto all'ultima release su GitHub.

Configurazione

Come puntare la tua applicazione all'SMTP locale

La configurazione è la stessa con tutti e tre gli strumenti: l'host è localhost (o il nome del servizio se la tua applicazione gira in Docker Compose), la porta è quella su cui ascolta lo strumento e non servono crittografia né nome utente. Il mittente può essere qualsiasi indirizzo.

# Symfony (.env.local)
MAILER_DSN=smtp://localhost:1025

# Laravel (.env)
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025

# Node.js (Nodemailer)
nodemailer.createTransport({host: 'localhost', port: 1025, secure: false});

Mantieni questa configurazione solo nel tuo ambiente locale. In staging e produzione la stessa applicazione deve usare un server SMTP reale con le proprie credenziali.

Produzione

Dai test in locale all'invio reale

Questi strumenti non consegnano email, quindi non possono dirti se i tuoi messaggi arriveranno nella inbox. Per questo devi inviare con il tuo dominio autenticato (SPF e DKIM) da un server con buona reputazione e vedere lo stato reale di ogni email.

L'approccio più pratico è mantenere la stessa forma di configurazione in ogni ambiente e cambiare solo host, porta e credenziali: localhost:1025 in sviluppo e l'SMTP del tuo provider in staging e produzione.

  • Usa credenziali diverse in ogni ambiente e tienile fuori dal repository.
  • Verifica il tuo dominio presso il provider prima del primo invio reale.
  • Testa i flussi completi (registrazione, password, ordine) in staging con gli indirizzi del tuo team.
  • Controlla nel registro del provider che le email vengano consegnate e come vengono gestiti i bounce.
FAQ

Domande frequenti

MailHog funziona ancora?

Si avvia ancora, ma la sua ultima release è di agosto 2020 e non riceve aggiornamenti di sicurezza. Per un nuovo progetto, Mailpit copre le stesse funzioni sulle stesse porte predefinite.

Mailpit o Papercut SMTP?

Mailpit funziona su Windows, Linux, macOS e Docker, si usa dal browser e ha un'API per i test automatici. Papercut è più comodo se lavori su Windows e vuoi un'app desktop che ti avvisi di ogni email.

Questi strumenti consegnano l'email al destinatario?

No. La intercettano e la mostrano, ma non la consegnano mai. Mailpit e Papercut possono essere configurati per fare relay verso un server SMTP esterno, ma per impostazione predefinita nessun messaggio esce dalla tua macchina.

Quale porta imposto nella mia applicazione?

1025 con Mailpit o MailHog. Con Papercut, 25 per l'app desktop o 2525 se usi la sua immagine Docker. In ogni caso, senza crittografia né autenticazione.

Mailiqo

Quando passi in produzione

Mailiqo invia le email della tua applicazione con il tuo dominio autenticato, via SMTP o API, e registra lo stato di ogni email nel pannello. Inizia gratis, senza carta.

Crea un account gratuito
Mailiqo Labs

Metti in pratica la guida

Gli strumenti ti permettono di controllare SPF, DMARC, intestazioni, bounce e HTML con i tuoi dati, senza registrarti.