MailCatcher NG (Next Generation)

Catches mail and serves it through a dream.

MailCatcher NG runs a super simple SMTP server which catches any message sent to it to display in a web interface. Run mailcatcher, set your favourite app to deliver to smtp://127.0.0.1:1025 instead of your default SMTP server, then check out http://127.0.0.1:1080 to see the mail that's arrived so far.

• Quick Start
• Features
• Documentation
  • Installation & Setup
  • Usage & Configuration
  • Framework Integration
  • REST API
  • Advanced Features
  • Credits
• License

1. gem install mailcatcher-ng
2. mailcatcher
3. Go to http://127.0.0.1:1080/
4. Send mail through smtp://127.0.0.1:1025

• Catches all mail and stores it for display
• Shows HTML, Plain Text, and Source versions of messages
• Rewrites HTML for safe display with embedded images
• Downloads original email to view in any mail client
• WebSockets real-time updates with automatic reconnection
• Runs as a daemon in the background, or in foreground mode
• catchmail command for PHP and sendmail-compatible systems
• Keyboard navigation between messages
• Email authentication verification (DMARC, DKIM, SPF)
• Email encryption & signature support (S/MIME, OpenPGP)
• BIMI (Brand Indicators for Message Identification) display
• Advanced preview text extraction with intelligent fallback
• Full UTF-8 and 8bit MIME transfer encoding support (SMTPUTF8, 8BITMIME)
• Multiple encoding support (7bit, 8bit, base64, quoted-printable)
• SSL/TLS encryption (STARTTLS & direct TLS/SMTPS)
• Charset preservation for international content

For a comprehensive list of all features, see FEATURES.md.

Detailed documentation is organized by topic:

Get MailCatcher NG up and running. Covers gem installation, source compilation, Docker, and special scenarios like RVM and Bundler.

Learn how to run MailCatcher NG, command-line options, development mode, and web interface features.

Configure your framework (Rails, Django, PHP, Docker) to send mail through MailCatcher NG.

Programmatic access to messages. Query, download, and manage messages via HTTP.

SSL/TLS encryption, UTF-8 and international content, email authentication, and more.

About MailCatcher NG and the original MailCatcher project.

MailCatcher NG is released under the MIT License, see LICENSE for details.