This is a Vagrant Environment for a Mail Server. It provides the Message Transfer Agent (MTA) and the Mail Delivery Agent (MDA).
This lets you easily test your application code against a real sandboxed Mail Server.
It uses the following software stack:
- Postfix to the handle mail storage, reception, and transmission using the Simple Mail Transfer Protocol (SMTP).
- Dovecot to access the mail storage using the Internet Message Access Protocol (IMAP).
- Dovecot for providing User Authentication to Postfix (SMTP AUTH) through the Simple Authentication and Security Layer (SASL).
- PowerDNS to handle the internal Domain Name System (DNS).
- nginx to serve the Automatic Mail Account Configuration (aka Autoconfiguration) endpoint.
Build and install the Ubuntu Base Box.
Run vagrant up to configure the mail.example.com mail server environment.
Configure your system /etc/hosts file with the example.com and mail.example.com domains:
192.168.33.254 example.com
192.168.33.254 mail.example.com
Access http://mail.example.com and follow the instructions to configure your Mail Client with a pre-configured account (all use the password password):
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
This also has some pre-configured aliases to [email protected]:
root
abuse
postmaster
hostmaster
mailer-daemon
At http://mail.example.com/examples you have some examples on how to programmatically use the mail server (e.g. from Python).
To troubleshoot, watch the Mail Server logs with vagrant ssh and journalctl --follow.