2017-04-16 23:27:46 +00:00
|
|
|
MailHog [  ](https://github.com/mailhog/MailHog/releases/tag/v1.0.0) [](https://godoc.org/github.com/mailhog/MailHog) [](https://travis-ci.org/mailhog/MailHog)
|
2014-04-20 16:17:00 +00:00
|
|
|
=========
|
|
|
|
|
|
|
|
|
|
Inspired by [MailCatcher](http://mailcatcher.me/), easier to install.
|
|
|
|
|
|
2015-01-08 21:25:23 +00:00
|
|
|
* Download and run MailHog
|
|
|
|
|
* Configure your outgoing SMTP server
|
|
|
|
|
* View your outgoing email in a web UI
|
|
|
|
|
* Release it to a real mail server
|
|
|
|
|
|
2015-01-04 13:06:46 +00:00
|
|
|
Built with Go - MailHog runs without installation on multiple platforms.
|
2014-04-20 16:17:00 +00:00
|
|
|
|
2015-02-24 23:06:00 +00:00
|
|
|
### Overview
|
|
|
|
|
|
|
|
|
|
MailHog is an email testing tool for developers:
|
|
|
|
|
|
|
|
|
|
* Configure your application to use MailHog for SMTP delivery
|
|
|
|
|
* View messages in the web UI, or retrieve them with the JSON API
|
|
|
|
|
* Optionally release messages to real SMTP servers for delivery
|
|
|
|
|
|
2014-04-20 16:17:00 +00:00
|
|
|
### Getting started
|
|
|
|
|
|
2014-12-17 19:54:29 +00:00
|
|
|
1. Either:
|
2014-12-24 18:34:24 +00:00
|
|
|
* [Download the latest release](/docs/RELEASES.md) of MailHog for your platform
|
2019-12-23 17:44:00 +00:00
|
|
|
* [Run it from Docker Hub](https://registry.hub.docker.com/r/mailhog/mailhog/) or using the provided [Dockerfile](Dockerfile)
|
2014-12-24 18:34:24 +00:00
|
|
|
* [Read the deployment guide](/docs/DEPLOY.md) for other deployment options
|
2016-07-07 22:08:30 +00:00
|
|
|
* Install it with Homebrew on MacOS - `brew update && brew install mailhog`
|
2014-12-24 18:34:24 +00:00
|
|
|
2. [Configure MailHog](/docs/CONFIG.md), or use the default settings:
|
2015-01-04 13:06:46 +00:00
|
|
|
* the SMTP server starts on port 1025
|
|
|
|
|
* the HTTP server starts on port 8025
|
|
|
|
|
* in-memory message storage
|
2014-04-20 16:17:00 +00:00
|
|
|
|
2014-04-21 11:24:21 +00:00
|
|
|
### Features
|
|
|
|
|
|
2016-11-14 22:53:35 +00:00
|
|
|
See [MailHog libraries](docs/LIBRARIES.md) for a list of MailHog client libraries.
|
|
|
|
|
|
2014-04-21 11:24:21 +00:00
|
|
|
* ESMTP server implementing RFC5321
|
2014-04-24 18:58:34 +00:00
|
|
|
* Support for SMTP AUTH (RFC4954) and PIPELINING (RFC2920)
|
|
|
|
|
* Web interface to view messages (plain text, HTML or source)
|
2014-11-01 22:46:34 +00:00
|
|
|
* Supports RFC2047 encoded headers
|
2014-04-27 22:39:13 +00:00
|
|
|
* Real-time updates using EventSource
|
2014-04-27 16:31:43 +00:00
|
|
|
* Release messages to real SMTP servers
|
2014-12-24 13:21:21 +00:00
|
|
|
* Chaos Monkey for failure testing
|
2014-12-24 18:34:24 +00:00
|
|
|
* See [Introduction to Jim](/docs/JIM.md) for more information
|
2014-04-24 18:58:34 +00:00
|
|
|
* HTTP API to list, retrieve and delete messages
|
2015-02-24 23:06:00 +00:00
|
|
|
* See [APIv1](/docs/APIv1.md) and [APIv2](/docs/APIv2.md) documentation for more information
|
2015-05-27 17:08:44 +00:00
|
|
|
* [HTTP basic authentication](docs/Auth.md) for MailHog UI and API
|
2014-04-24 18:58:34 +00:00
|
|
|
* Multipart MIME support
|
2014-04-27 19:02:36 +00:00
|
|
|
* Download individual MIME parts
|
2014-04-24 18:58:34 +00:00
|
|
|
* In-memory message storage
|
2016-03-20 17:19:28 +00:00
|
|
|
* MongoDB and file based storage for message persistence
|
2014-04-21 11:24:21 +00:00
|
|
|
* Lightweight and portable
|
|
|
|
|
* No installation required
|
|
|
|
|
|
2015-05-26 21:58:57 +00:00
|
|
|
#### sendmail
|
|
|
|
|
|
|
|
|
|
[mhsendmail](https://github.com/mailhog/mhsendmail) is a sendmail replacement for MailHog.
|
|
|
|
|
|
|
|
|
|
It redirects mail to MailHog using SMTP.
|
|
|
|
|
|
|
|
|
|
You can also use `MailHog sendmail ...` instead of the separate mhsendmail binary.
|
|
|
|
|
|
2017-04-16 23:05:33 +00:00
|
|
|
Alternatively, you can use your native `sendmail` command by providing `-S`, for example:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
/usr/sbin/sendmail -S mail:1025
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
For example, in PHP you could add either of these lines to `php.ini`:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
sendmail_path = /usr/local/bin/mhsendmail
|
|
|
|
|
sendmail_path = /usr/sbin/sendmail -S mail:1025
|
|
|
|
|
```
|
|
|
|
|
|
2015-05-26 21:58:57 +00:00
|
|
|
#### Web UI
|
|
|
|
|
|
2014-12-24 18:34:24 +00:00
|
|
|
|
2014-04-21 11:24:21 +00:00
|
|
|
|
2014-04-20 16:17:00 +00:00
|
|
|
### Contributing
|
|
|
|
|
|
2015-01-04 13:06:46 +00:00
|
|
|
MailHog is a rewritten version of [MailHog](https://github.com/ian-kent/MailHog), which was born out of [M3MTA](https://github.com/ian-kent/M3MTA).
|
|
|
|
|
|
2014-12-24 17:48:01 +00:00
|
|
|
Clone this repository to ```$GOPATH/src/github.com/mailhog/MailHog``` and type ```make deps```.
|
2014-04-28 00:42:05 +00:00
|
|
|
|
2015-04-29 16:17:37 +00:00
|
|
|
See the [Building MailHog](/docs/BUILD.md) guide.
|
2014-12-21 07:55:53 +00:00
|
|
|
|
2015-05-27 17:30:50 +00:00
|
|
|
Requires Go 1.4+ to build.
|
2014-12-02 22:09:35 +00:00
|
|
|
|
2014-12-02 19:53:02 +00:00
|
|
|
Run tests using ```make test``` or ```goconvey```.
|
2014-04-20 16:17:00 +00:00
|
|
|
|
2014-06-24 21:24:54 +00:00
|
|
|
If you make any changes, run ```go fmt ./...``` before submitting a pull request.
|
2014-04-20 16:17:00 +00:00
|
|
|
|
|
|
|
|
### Licence
|
|
|
|
|
|
2017-04-16 23:27:46 +00:00
|
|
|
Copyright © 2014 - 2017, Ian Kent (http://iankent.uk)
|
2014-04-20 16:17:00 +00:00
|
|
|
|
2014-10-29 18:55:17 +00:00
|
|
|
Released under MIT license, see [LICENSE](LICENSE.md) for details.
|
