Skip to content

Latest commit

 

History

History
98 lines (59 loc) · 3.55 KB

how-to-catch-outgoing-emails-locally.md

File metadata and controls

98 lines (59 loc) · 3.55 KB
Raw

Catch outgoing emails locally for email workflows

Note: This is an optional step and is required only when working with email workflows

Introduction

Some email workflows, like updating a user's email, requires the back-end api-server to send outgoing emails. An alternative to using an email service provider to send actual email messages, Mailhog is a developer tool for email testing that will catch the email messages sent by your freeCodeCamp instance.

Installing MailHog

MailHog can be installed on macOS, Windows and Linux.

Installing MailHog on macOS

Install MailHog on macOS with Homebrew:

brew install mailhog
brew services start mailhog

The above commands will start a mailhog service in the background.

When the installation completes, you can start using MailHog.

Installing MailHog on Windows

Download the latest version of MailHog from MailHog's official repository. Locate and click on the link for your Windows version (32 or 64 bit) and .exe file will be downloaded to your computer.

When the download completes, click to open the file. A Windows firewall notification may appear requesting access permission for MailHog. A standard Windows command line prompt will open where MailHog will be running once firewall access is granted.

Close MailHog by closing the command prompt window. To start MailHog again, click on the MailHog executable (.exe) file that was downloaded initially - it is not necessary to download a new MailHog intallation file.

Start using MailHog.

Installing MailHog on Linux

First, install Go.

Run the following commands to install GO on Debian-based systems like Ubuntu and Linux Mint.

sudo apt-get install golang

Run the following commands to install GO on RPM-based systems like CentOS, Fedora, Red Hat Linux, ect.

sudo dnf install golang

Alternatively, run the following commands to install GO.

sudo yum install golang

Now set the path for Go with the following commands.

echo "export GOPATH=$HOME/go" >> ~/.profile
echo 'export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin' >> ~/.profile
source ~/.profile

Finally, enter the commanads below to install and run MailHog.

go get github.com/mailhog/MailHog
sudo cp /home/$(whoami)/go/bin/MailHog /usr/local/bin/mailhog
mailhog

Start using MailHog.

Using MailHog

Open a new browser tab or window and navigate to http://localhost:8025 to open your MailHog inbox when the MailHog installation has completed and MailHog is running. The inbox will appear similar to the screen shot below.

MailHog Screenshot 1

Emails sent by your freeCodeCamp installation will appear as below

MailHog Screenshot 2

Two tabs that allow you to view either plain text or source content will be available when you open a given email. Ensure that the plain text tab is selected as below.

MailHog Screenshot 3

All links in the email should be clickable and resolve to their URL.

Useful Links

  • Check out the MailHog repository for further information related to MailHog. Additional information is also available regarding custom MailHog configurations.