MailHog is a simple and powerful tool for capturing and viewing emails sent from your application during development or testing. It acts as a local SMTP server and provides a web interface for viewing the captured messages. This blog explains how to use MailHog with a .NET project for email sending and testing, and how to integrate it into CI pipelines.
Why Use MailHog?
Captures emails sent from development apps.
Web UI for viewing emails at http://localhost:8025 .
. Excellent for integration testing.
No real emails sent — safe for all environments.
Free!!
Running MailHog with Docker
The easiest way to start MailHog is with Docker:
docker run -d -p 1025:1025 -p 8025:8025 mailhog/mailhog Enter fullscreen mode Exit fullscreen mode
SMTP Server: localhost:1025
Web UI: http://localhost:8025
Or with a docker-compose.mailhog.yml file:
version : ' 3.8' services : mailhog : image : mailhog/mailhog ports : - " 1025:1025" - " 8025:8025" Enter fullscreen mode Exit fullscreen mode
Then run:
docker-compose -f docker-compose.mailhog.yml up -d Enter fullscreen mode Exit fullscreen mode
Sending Email with .NET and MailHog
Here’s how you can configure and use MailHog to send test emails in a .NET service.
SMTP Options
You can configure MailHog with no credentials and unencrypted SMTP:
// appsettings.Development.json { "Smtp" : { "Host" : "localhost" , "Port" : 1025 , "User" : "" , "Password" : "" } } Enter fullscreen mode Exit fullscreen mode
The Email Service Class
This service uses MailKit and MimeKit to send email messages:
public class SmtpEmailService : IEmailService { private readonly SmtpOptions _smtpOptions ; public SmtpEmailService ( IOptions < SmtpOptions > smtpOptions , ILogger < SmtpEmailService > logger ) { _smtpOptions = smtpOptions . Value ; } public async Task SendEmailAsync ( EmailSendRequestedEvent emailEvent ) { var message = new MimeMessage (); message . From . Add ( new MailboxAddress ( "FinTrack" , "no-reply@fintrack.com" )); message . To . Add ( new MailboxAddress ( emailEvent . ToName ?? emailEvent . To , emailEvent . To )); message . Subject = emailEvent . Subject ; message . Body = emailEvent . IsHtml ? new TextPart ( "html" ) { Text = emailEvent . Body } : new TextPart ( "plain" ) { Text = emailEvent . Body }; using var client = new SmtpClient (); await client . ConnectAsync ( _smtpOptions . Host , _smtpOptions . Port , SecureSocketOptions . None ); await client . AuthenticateAsync ( _smtpOptions . User , _smtpOptions . Password ); await client . SendAsync ( message ); await client . DisconnectAsync ( true ); } } Enter fullscreen mode Exit fullscreen mode
Use SecureSocketOptions.None because MailHog does not support SSL or STARTTLS.
Unit Test Example
Use mock IOptions and ILogger , then run a real test that talks to MailHog:
[ Fact ] public async Task SendAsync_WithValidInput_SendsEmailWithoutException () { var smtpOptions = new SmtpOptions { Host = "localhost" , Port = 1025 , User = "" , Password = "" }; var optionsMock = new Mock < IOptions < SmtpOptions >>(); optionsMock . Setup ( o => o . Value ). Returns ( smtpOptions ); var loggerMock = new Mock < ILogger < SmtpEmailService >>(); var emailService = new SmtpEmailService ( optionsMock . Object , loggerMock . Object ); var emailEvent = new EmailSendRequestedEvent { From = "from@test.com" , To = "to@test.com" , ToName = "Receiver" , Subject = "Test Subject" , Body = "Test Body" , IsHtml = false }; await emailService . SendEmailAsync ( emailEvent ); } Enter fullscreen mode Exit fullscreen mode
Once this test runs, visit http://localhost:8025 and you’ll see the message inside MailHog's web UI. No real emails will be sent — perfect for development and CI.
Can You Set Password for MailHog?
MailHog does not support SMTP authentication or TLS encryption. It’s intentionally insecure for local use only.
CI Integration
You can easily run MailHog inside GitHub Actions with this snippet:
services : mailhog : image : mailhog/mailhog ports : - 1025:1025 - 8025:8025 Enter fullscreen mode Exit fullscreen mode
Then point your tests to localhost:1025 , and run them just like local.
MailHog is a powerful and easy-to-use tool for safely testing email logic without sending real emails. It's perfect for local development, integration testing, and even CI environments.
MailHog для .NET: безопасное тестирование email с локальным SMTP сервером
MailHog — мощный и простой инструмент для перехвата и отображения писем в процессе разработки. Он работает как локальный SMTP сервер с удобным веб-интерфейсом. Как вы обеспечиваете безопасность тестовой почты в своих проектах?
Запуск MailHog в Docker требует минимальных усилий. С помощью одной команды можно развернуть его на локальной машине. Готовы ли вы ускорить настройку среды разработки?
Интеграция с .NET-проектом сводится к простой настройке SMTP параметров. Конфигурация через appsettings.Development.json и использование MailKit делают процесс интуитивно понятным. Хотите протестировать email-логику без лишних хлопот?
Юнит-тесты с использованием моков для IOptions и ILogger демонстрируют практичность решения. Реальный тест приводит к появлению письма в MailHog, подтверждая корректность работы сервиса. Насколько критична для вас автоматизация процессов?
CI-среды, включая GitHub Actions, легко интегрируются с MailHog благодаря Docker-контейнерам. Это позволяет запускать тесты так же просто, как в локальном режиме. Готовы ли вы перейти на новый уровень автоматизации?
MailHog позволяет тестировать email-логику без отправки реальных писем – идеальное решение для разработки и CI. Попробуйте настроить его сегодня и убедитесь: безопасность может быть простой и эффективной!
MailHog для .NET: безопасная отладка email через локальный SMTP сервер
MailHog – мощное решение для перехвата писем в процессе разработки. Он имитирует SMTP сервер и предоставляет веб-интерфейс для просмотра тестовых email. Готовы ли вы оптимизировать тестирование без риска отправки реальных писем?
Запуск MailHog с Docker занимает считанные секунды. Достаточно одной команды или docker-compose файла для развертывания сервиса. Хотите ускорить процесс настройки и интеграции в CI?
Интеграция с .NET-проектом сводится к простой конфигурации SMTP через appsettings.Development.json. Использование MailKit и MimeKit делает отправку писем интуитивно понятной. Как вы минимизируете сложности настройки email логики в своих проектах?
Юнит-тесты с моками для IOptions и ILogger демонстрируют практичность MailHog в реальном тестировании почтовых сценариев. После теста письмо появится в веб-интерфейсе сервиса по адресу http://localhost:8025. Готовы ли вы убедиться в работоспособности своих email-сервисов?
Интеграция MailHog в CI, например, через GitHub Actions, не вызывает сложностей – достаточно запустить соответствующий Docker контейнер. Это позволяет тестировать логику отправки писем аналогично локальной среде. Попробуйте MailHog уже сегодня – безопасность тестовой почты может быть проще, чем вы думаете!
Blog article about MailHog: How to Catch Test Emails in .NET and CI Risk-Free
MailHog: Email Testing Without Compromise
Ever wondered how to catch emails without sending them live? Experience the thrill by setting up a local SMTP and instantly checking results in a user-friendly web interface!
Блог-статья о MailHog: как ловить тестовые письма в .NET и CI без риска.
MailHog: Email-тестирование без компромиссов
Задумывались, как отлавливать письма, не отправляя их в бой? Почувствуйте драйв, подключив локальный SMTP и мгновенно проверяя результаты в удобном web-интерфейсе!
Подробнее в ТГ: @DevPulseAI
testing #functionalTesting
Blog | MailHog lets you safely test email sending without the risk of dispatching real messages
MailHog: uncompromised email testing in .NET
MailHog is a simple tool for intercepting test emails during development. It runs as a local SMTP server with an intuitive web interface.
Блог | MailHog позволяет безопасно тестировать отправку email без риска отправки реальных писем
MailHog: тестирование почты в .NET без компромиссов
MailHog — простой инструмент для отлова тестовых писем в процессе разработки. Он запускается как локальный SMTP сервер с понятным web-интерфейсом.
Подробнее в ТГ: @DevPulseAI
Top comments (0)