Mailgun is a third-party email service that offers Compute Engine users up to 30,000 free emails each month. MailGun also offers a programmatic API, log retention, email personalization, analytics, email validation, and more.
Follow these instructions to sign up for and use Mailgun.
Before you begin
Create a new Mailgun account on Mailgun's Google partner page*. As a Compute Engine user, your first 30,000 messages are free every month. Check out the Mailgun monthly pricing calculator for pricing on additional messages and volume discounts.
Get your credentials. The instructions will require that you know your Mailgun SMTP username, password, and hostname. Get your username and password from the Mailgun control panel, under the Domains section.
The Mailgun SMTP hostname is smtp.mailgun.org.
Relay with Postfix
Configuring Mailgun as a mail relay allows Postfix to forward emails destined for remote delivery.
Connect to your instance using SSH:
gcloud compute ssh INSTANCE
Become a superuser and set a safe umask:
user@test-instance:~$ sudo su -
root@test-instance:~# umask 077
Install the Postfix Mail Transport Agent. When prompted, accept the default choices for domain names but select the
root@test-instance:~# apt-get update && apt-get install postfix libsasl2-modules -y
root@test-instance:~# yum install postfix cyrus-sasl-plain cyrus-sasl-md5 -y
Modify the Postfix configuration options. Postfix configuration options are set in the
main.cffile. Open the file with the text editor of your choice:
root@test-instance:~# vi /etc/postfix/main.cf
If they exist, comment out the following lines:
# default_transport = error # relay_transport = error
Add the Mailgun SMTP service by adding the following line to the end of the file:
relayhost = [smtp.mailgun.org]:2525
Note: You must use port 2525, as port 25 is not allowed on Compute Engine.
Next, add the following lines to enforce SSL/TLS support and to configure STMP authentication for these requests. A simple access and security layer (SASL) module handles authentication in the Postfix configuration. Add the following lines to the end of the file:
smtp_tls_security_level = encrypt smtp_sasl_auth_enable = yes smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd smtp_sasl_security_options = noanonymous
Save your changes and close the file.
Generate the SASL password map:
root@test-instance:~# cat > /etc/postfix/sasl_passwd << EOF [smtp.mailgun.org]:2525 YOUR_SMTP_LOGIN:YOUR_SMTP_PASSWORD EOF
postmaputility to generate a
root@test-instance:~# postmap /etc/postfix/sasl_passwd
root@test-instance:~# ls -l /etc/postfix/sasl_passwd* -rw------- 1 root root 68 Jun 1 10:50 /etc/postfix/sasl_passwd -rw------- 1 root root 12288 Jun 1 10:51 /etc/postfix/sasl_passwd.db
Next, remove the file containing your credentials as it is no longer needed:
root@test-instance:~# rm /etc/postfix/sasl_passwd
Set the permissions on your
root@test-instance:~# chmod 600 /etc/postfix/sasl_passwd.db
root@test-instance:~# ls -la /etc/postfix/sasl_passwd.db -rw------- 1 root root 12288 Aug 31 18:51 /etc/postfix/sasl_passwd.db
Finally, reload your configuration to load the modified parameters:
root@test-wheezy:~# /etc/init.d/postfix restart
[root@test-centos ~]# postfix reload
Test your configuration. Install the
mailutilspackage and test your configuration.
root@test-wheezy:~# apt-get install mailutils -y
[root@test-centos ~]# yum install mailx -y
Send a test message:
root@test-instance:~# echo 'Test passed.' | mail -s Test-Email EMAIL@EXAMPLE.COM
Look in your systems logs for a status line containing
statusand the successful server response code
root@test-wheezy:~# tail -n 5 /var/log/syslog
[root@test-centos ~]# tail -n 5 /var/log/maillog
For more detailed examples and information about many other topics including tracking and routing messages, read the Mailgun documentation.
Mailgun SMTP settings
Here is a quick reference to Mailgun-specific SMTP settings that are used to configure clients:
- Host: smtp.mailgun.org
- Port: 2525
* Google will be compensated for customers who sign up for a non-free account.
Try out other Google Cloud Platform features for yourself. Have a look at our tutorials.