Use Mailhog for E-mail testing

This article is valid for Smart ID 21.04 and later.

Mailhog is a tool that can be used when testing sending emails with the Smart ID component Identity Manager.

Useful commands

<SMARTIDHOME>/tools/mailhog/docker-compose up -d

<SMARTIDHOME>/tools/mailhog/docker-compose stop

<SMARTIDHOME>/tools/mailhog/docker-compose logs -f

Change mailhog ports

1. Edit <SMARTIDHOME>/tools/mailhog/docker-compose.yml and change the ports to the left of the colons. You must restart the container to apply the changes.

   Change ports

   CODE

       ports:
         - 1025:1025 # smtp server
         - 8025:8025 # web ui

2. Configure your Smart ID component with the following settings if mailhog is deployed to the same host as the component. If mailhog is deployed to another host, replace the SMTP host with the hostname/ip address, and make sure that the Smart ID host can access mailhog on port 1025.
   

   CODE

   SMTP Host: mailhog
   SMTP Port: 1025
   Sender: test@example.com

   Example for Identity Manager

   1. Log in to Identity Manager Operator.
   2. Go to the Admin page.
   3. Click Configure system properties.
   4. Click SMPT Settings.
   5. Enter port number 1025.

3.  Access the web interface to see emails. Browse to the host where mailhog is deployed on port 8025.
   

   Access emails

   CODE

   http://SMARTID-HOST>:8025