#

Working with emails

When you are working with emails locally, you need to make sure that these emails don't leave your machine and get sent to real users, but it's also important to being able to inspect them easily.

Herd Pro provides an SMTP mail server on your local machine that catches all outgoing emails instead of sending them to the world. It displays them in Herds own email client and provides rich debugging capabilities for all types of emails.

This saves you from sending emails to real users and frees you up from paying cloud services for developer email inboxes, not even requiring you to dig through log files when using the log driver. It's also super fast and organizes all emails per site.

#

Setup

[!NOTE]
When using laravel new or Herd's site creation wizard, the Herd mail server is automatically configured for you.

The mail server uses the SMTP protocol to accept mails but instead of sending them to their recipient, it saves them to an internal database.

You can use the settings below and add them to your local .env file to receive mail in the Herd Pro mail UI.

MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=${APP_NAME}
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="${APP_NAME}"

Herd Pro groups incoming mails by the username of the mail sender. This allows you to create a dedicated inbox for each project you are working on. Either specify a unique username manually, or use the APP_NAME environment variable to automatically use your application's name as the inbox name. Depending on your application name, you might need to set the username for your mailbox manually before emails show up in Herd.

#

Changing the port

By default, the Herd Pro mail server runs on port 2525 but you can customize this configuration in the settings.

#

Inspecting mails

You may inspect the header values of an email by opening the sidebar of the email window at the top right.

The HTML source of the email or the raw email content are available via right-click on the email itself. They open in a new window, and you can open raw or HTML content of multiple mails at the same time.

#

Attachments

Herd stores all attachments in your Herd application directory and creates a folder for each email with all attached files. You can either open them from this folder or directly from the email.

%USERPROFILE%\.config\herd\log\mail

#

Deleting mails

You can delete single emails by selecting the email and pressing the Backspace key but if you want to get rid of a whole inbox, you can use the trash icon in the top bar of the mail window.

#

Troubleshooting

If you accidentally sent thousands of emails to Herd or something is wrong, you can go to the settings and press the Delete all Mails button to reset the mail debugger completely.

If you accidentally enable TLS connections to the mail server, it may crash and needs a restart via the dashboard or system tray menu.