Indexed by TopGit from live GitHub metadata: sj26/mailcatcher has 6.8k stars, written primarily in Ruby. Catches mail and serves it through a dream.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
MailCatcher 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.
Features
Catches all mail and stores it for display.
Shows HTML, Plain Text and Source version of messages, as applicable.
Rewrites HTML enabling display of embedded, inline images/etc and opens links in a new window.
Lists attachments and allows separate downloading of parts.
Download original email to view in your native mail client(s).
Command line options to override the default SMTP/HTTP IP and port settings.
Mail appears instantly if your browser supports WebSockets, otherwise updates every thirty seconds.
Runs as a daemon in the background, optionally in foreground.
Sendmail-analogue command, catchmail, makes using mailcatcher from PHP a lot easier.
Keyboard navigation between messages
How
gem install mailcatcher
mailcatcher
Go to http://127.0.0.1:1080/
Send mail through smtp://127.0.0.1:1025
Command Line Options
Use mailcatcher --help to see the command line options.
Usage: mailcatcher [options]
MailCatcher v0.8.0
--ip IP Set the ip address of both servers
--smtp-ip IP Set the ip address of the smtp server
--smtp-port PORT Set the port of the smtp server
--http-ip IP Set the ip address of the http server
--http-port PORT Set the port address of the http server
--messages-limit COUNT Only keep up to COUNT most recent messages
--http-path PATH Add a prefix to all HTTP paths
--no-quit Don't allow quitting the process
-f, --foreground Run in the foreground
-b, --browse Open web browser
-v, --verbose Be more verbose
-h, --help Display this help information
--version Display the current version
Upgrading
Upgrading works the same as installation:
gem install mailcatcher
Ruby
MailCatcher requires Ruby 3.3 or newer.
If you have trouble with the setup commands, make sure you have Ruby installed:
ruby -v
gem environment
You might need to install build tools for some of the gem dependencies. On Debian or Ubuntu, apt install build-essential. On macOS, xcode-select --install.
Please don't put mailcatcher into your Gemfile. It will conflict with your application's gems at some point.
Instead, pop a note in your README stating you use mailcatcher, and to run gem install mailcatcher then mailcatcher to get started.
RVM
Under RVM your mailcatcher command may only be available under the ruby you install mailcatcher into. To prevent this, and to prevent gem conflicts, install mailcatcher into a dedicated gemset with a wrapper script:
rvm default@mailcatcher --create do gem install mailcatcher
ln -s "$(rvm default@mailcatcher do rvm wrapper show mailcatcher)" "$rvm_bin_path/"
Rails
To set up your rails app, I recommend adding this to your environments/development.rb:
For projects using PHP, or PHP frameworks and application platforms like Drupal, you can set PHP's mail configuration in your php.ini to send via MailCatcher with:
If you've installed via RVM this probably won't work unless you've manually added your RVM bin paths to your system environment's PATH. In that case, run which catchmail and put that path into the sendmail_path directive above instead of /usr/bin/env catchmail.
If starting mailcatcher on alternative SMTP IP and/or port with parameters like --smtp-ip 192.168.0.1 --smtp-port 10025, add the same parameters to your catchmail command:
How those ports appear and can be accessed may vary based on your Docker configuration. For example, your may need to use http://127.0.0.1:1080 etc instead of the listed address. But MailCatcher will run and listen to those ports on all IPs it can from within the Docker container.
API
A fairly RESTful URL schema means you can download a list of messages in JSON from /messages, each message's metadata with /messages/:id.json, and then the pertinent parts with /messages/:id.html and /messages/:id.plain for the default HTML and plain text version, /messages/:id/parts/:cid for individual attachments by CID, or the whole message with /messages/:id.source.
Caveats
MailCatcher is a development tool, not a public mail service. Message previews and directly opened message parts disable scripts and forms, but remote images and styles can still load. Links open normal browser tabs; downloaded files are not sandboxed by MailCatcher.
Mail processing is fairly basic but easily modified. If something doesn't work for you, fork and fix it or file an issue and let me know. Include the whole message you're having problems with.
Encodings are difficult. MailCatcher does not completely support utf-8 straight over the wire, you must use a mail library which encodes things properly based on SMTP server capabilities.
Thanks
MailCatcher is just a mishmash of other people's hard work. Thank you so much to the people who have built the wonderful guts on which this project relies.
Donations
I work on MailCatcher mostly in my own spare time. If you've found Mailcatcher useful and would like to help feed me and fund continued development and new features, please donate via PayPal. If you'd like a specific feature added to MailCatcher and are willing to pay for it, please email me.
The most recent commit recorded on sj26/mailcatcher was 11 days ago, based on the GitHub push timestamp. The repository has 605 forks — one of the better signals of community interest.
How many stars does sj26/mailcatcher have?
sj26/mailcatcher has 6.8k GitHub stars — refresh the page for the live number, or check github.com/sj26/mailcatcher. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is sj26/mailcatcher open source?
TopGit's metadata for sj26/mailcatcher does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What else is in the Backend space?
sj26/mailcatcher is tracked by TopGit under the Backend category, alongside 8 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What topics is sj26/mailcatcher associated with?
GitHub's repository topics for sj26/mailcatcher: "development", "devtools", "mail", "rails", "ruby", "rubygems", "server", "smtp". TopGit's editorial category is Backend.
Where can I see sj26/mailcatcher in action?
The project maintains a homepage at http://mailcatcher.me. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about sj26/mailcatcher?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/sj26/mailcatcher is the definitive source.
Read full README in the tab above.
Want a second opinion on mailcatcher?
Ask an AI that can read this page — one click and you get its take on mailcatcher.