Web and API based SMTP testing
Find a file
2014-04-26 13:12:26 +01:00
images Update readme and screenshot 2014-04-24 19:58:34 +01:00
mailhog Message preview UI fixes 2014-04-26 13:12:26 +01:00
auth_test.go More auth tests, fix bug 2014-04-22 23:27:07 +01:00
main.go Default to in-memory storage 2014-04-24 19:16:35 +01:00
main_test.go Add in-memory storage, clean up config 2014-04-24 00:22:50 +01:00
mime_test.go Add in-memory storage, clean up config 2014-04-24 00:22:50 +01:00
README.md Update readme and screenshot 2014-04-24 19:58:34 +01:00

Go-MailHog

Inspired by MailCatcher, easier to install.

Go-MailHog is a rewritten version of MailHog, which was born out of M3MTA.

Go was chosen for portability - MailHog runs without installation on multiple platforms.

Requirements

  • None!

Getting started

  • Download the latest release of Go-MailHog for your platform
  • Start MailHog

By default, the SMTP server will start on port 1025, and the HTTP server will start on port 8025.

Features

  • ESMTP server implementing RFC5321
  • Support for SMTP AUTH (RFC4954) and PIPELINING (RFC2920)
  • Web interface to view messages (plain text, HTML or source)
  • HTTP API to list, retrieve and delete messages
  • Multipart MIME support
  • In-memory message storage
  • MongoDB storage for message persistence
  • Lightweight and portable
  • No installation required

Screenshot of MailHog web interface

Configuration

You can configure Go-MailHog using command line options:

Parameter Default Description
-hostname mailhog.example Hostname to use for EHLO/HELO and message IDs
-httpbindaddr 0.0.0.0:8025 Interface and port for HTTP server to bind to
-mongocoll messages MongoDB collection name for message storage
-mongodb mailhog MongoDB database name for message storage
-mongouri 127.0.0.1:27017 MongoDB host and port
-smtpbindaddr 0.0.0.0:1025 Interface and port for SMTP server to bind to
-storage memory Set message storage: memory / mongodb

Contributing

Clone this repository to $GOPATH/src/github.com/ian-kent/MailHog and type go install.

Run tests using go test. You'll need a copy of MailHog running for tests to pass. (Tests currently fail using in-memory storage, use MongoDB!)

If you make any changes, run go fmt before submitting a pull request.

Licence

Copyright ©‎ 2014, Ian Kent (http://www.iankent.eu).

Released under MIT license, see LICENSE for details.