mailhog /MailHog

Web and API based SMTP testing

★ 16,209⑂ 1,181👁 150⑃ 107● 368▤ 23
GoMITCreated 2014-04-16
下载:Mailhog 1.0.1Mailhog-1.0.1 ↓1.0.12020-08-11
+2
日增长
16,209
stars
1,181
forks
150
watchers
107
prs
368
issues
23
releases

README

MailHog  ![Download ](https://github.com/mailhog/MailHog/releases/tag/v1.0.0)  
=========

Inspired by MailCatcher, easier to install.

 Download and run MailHog
 Configure your outgoing SMTP server
 View your outgoing email in a web UI
 Release it to a real mail server

Built with Go - MailHog runs without installation on multiple platforms.

 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

 Installation

 Manual installation
Download the latest release for your platform. Then
read the deployment guide for deployment options.

 MacOS
bash
brew update && brew install mailhog


Then, start MailHog by running mailhog in the command line.

 Debian / Ubuntu Go = v1.17 (Debian Bookworm) 
bash
sudo apt-get -y install golang-go
go install github.com/mailhog/MailHog@latest


Then, start MailHog by running /path/to/MailHog in the command line.

E.g. the path to Go's bin files on Ubuntu is ~/go/bin/, so to start the MailHog run:

bash
~/go/bin/MailHog


 FreeBSD
bash
pkg install mailhog
sysrc mailhog_enable="YES"
service mailhog start


 Docker
Run it from Docker Hub or using the provided Dockerfile

 Configuration

Check out how to configure MailHog, or use the default settings:
   the SMTP server starts on port 1025
   the HTTP server starts on port 8025
   in-memory message storage

 Features

See MailHog libraries for a list of MailHog client libraries.

 ESMTP server implementing RFC5321
 Support for SMTP AUTH (RFC4954) and PIPELINING (RFC2920)
 Web interface to view messages (plain text, HTML or source)
   Supports RFC2047 encoded headers
 Real-time updates using EventSource
 Release messages to real SMTP servers
 Chaos Monkey for failure testing
   See Introduction to Jim for more information
 HTTP API to list, retrieve and delete messages
   See APIv1 and APIv2 documentation for more information
 HTTP basic authentication for MailHog UI and API
 Multipart MIME support
 Download individual MIME parts
 In-memory message storage
 MongoDB and file based storage for message persistence
 Lightweight and portable
 No installation required

 sendmail

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.

Alternatively, you can use your native sendmail command by providing -S, for example:

bash
/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


 Web UI

!Screenshot of MailHog web interface

 Contributing

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

Clone this repository to $GOPATH/src/github.com/mailhog/MailHog and type make deps.

See the Building MailHog guide.

Requ

Top issues

Latest release

Mailhog 1.0.1 v1.0.1 2020-08-11
This is a minor bump, to get the project moving again, and to release some small changes including

 Change to official Golang docker image
 Documentation updates
 Addition of Ubuntu snap

The target cadence going forward will be a minor release every three months, with features and enhancements. Security or bug fixes will be released as path releases.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON