Deploying MailHog

Command line

You can run MailHog locally from the command line.

go get github.com/mailhog/MailHog
MailHog -h

To configure MailHog, use the environment variables or command line flags described in the CONFIG.

Using supervisord/upstart/etc

MailHog can be started as a daemon using supervisord/upstart/etc.

See this example init script and this Ansible role by geerlingguy.

If installed with Homebrew on OSX you can have launchd start mailhog now and restart at login: brew services start mailhog

Docker

The example Dockerfile can be used to run MailHog in a Docker container.

You can run it directly from Docker Hub (thanks humboldtux)

docker run -d -p 1025:1025 -p 8025:8025 mailhog/mailhog

To mount the Maildir to the local filesystem, you can use a volume:

docker run -d -e "MH_STORAGE=maildir" -v $PWD/maildir:/maildir -p 1025:1025 -p 8025:8025 mailhog/mailhog

Elastic Beanstalk

You can deploy MailHog using AWS Elastic Beanstalk.

Open the Elastic Beanstalk console
Create a zip file containing the Dockerfile and MailHog binary
Create a new Elastic Beanstalk application
Launch a new environment and upload the zip file

Note You'll need to reconfigure nginx in Elastic Beanstalk to expose both ports as TCP, since by default it proxies the first exposed port to port 80 as HTTP.

If you're using in-memory storage, you can only use a single instance of MailHog. To use a load balanced EB application, use MongoDB backed storage.

To configure your Elastic Beanstalk MailHog instance, either:

Set environment variables using the Elastic Beanstalk console
Edit the Dockerfile to pass in command line arguments

You may face restrictions on outbound SMTP from EC2, for example if you are releasing messages to real SMTP servers.

SaltStack

For deploying MailHog using SaltStack, there's a SaltStack Formula available in github.com/ssc-services/salt-formulas-public.

2.4 KiB Raw Blame History