Configure Postfix to Use Gmail SMTP on Ubuntu

Postfix is an open-source mail transfer agent (MTA) that allows users to send and receive email on Linux systems. It is an efficient and easy-to-use solution that can be configured to work with various email providers, including Gmail.

In this article, we will show you the steps to configure Postfix using Gmail SMTP on Ubuntu. This process involves setting up your Gmail account to allow apps to access it, installing and configuring Postfix, and testing the setup to ensure it works correctly.

Why Use Gmail SMTP with Postfix?

Using Gmail SMTP with Postfix offers several benefits:

  • Reliability Gmail has a robust infrastructure that ensures your emails are delivered without issues.

  • Security Gmail SMTP uses encrypted connections to protect your email data from interception.

  • Spam Protection Gmail has advanced spam filters that help prevent your emails from being marked as spam.

  • Cost-effective Gmail provides free SMTP service up to a certain limit, making it ideal for small businesses and individuals.

Step 1: Configure Gmail Authentication

Before using Gmail SMTP with Postfix, you need to set up proper authentication. For accounts with two-factor authentication (2FA) enabled, you must create an App Password:

  • Go to your Google Account Security page

  • Click on App passwords section

  • Select Mail and Other (Custom name) from the dropdown menu

  • Enter a custom name like "Postfix" and click Generate

  • Copy the generated 16-character password for later use

Note: If you don't have 2FA enabled, Google strongly recommends enabling it for better security instead of using less secure app access.

Step 2: Install Postfix

Install Postfix on your Ubuntu system using the following command:

sudo apt update
sudo apt install postfix

During installation, you'll be prompted to select a mail server configuration type. Choose Internet Site and provide your system's fully qualified domain name when requested.

Step 3: Configure Postfix Main Settings

Edit the main Postfix configuration file:

sudo nano /etc/postfix/main.cf

Add the following Gmail SMTP configuration at the end of the file:

# Gmail SMTP settings
relayhost = [smtp.gmail.com]:587
smtp_sasl_auth_enable = yes
smtp_sasl_security_options = noanonymous
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_tls_security_level = encrypt
smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt
smtp_use_tls = yes

Step 4: Create Authentication File

Create a password file containing your Gmail credentials:

sudo nano /etc/postfix/sasl_passwd

Add your Gmail authentication details:

[smtp.gmail.com]:587 your_email@gmail.com:your_app_password

Replace your_email@gmail.com with your Gmail address and your_app_password with the App Password generated in Step 1.

Secure the file and create the hash database:

sudo chmod 600 /etc/postfix/sasl_passwd
sudo postmap /etc/postfix/sasl_passwd

Step 5: Install Required Packages

Install the SASL authentication library:

sudo apt install libsasl2-modules ca-certificates

Step 6: Restart and Test Postfix

Restart the Postfix service to apply the changes:

sudo systemctl restart postfix
sudo systemctl status postfix

Test the configuration by sending a test email:

echo "This is a test message from Postfix" | mail -s "Test Email" recipient@example.com

Check the mail logs for any errors:

sudo tail -f /var/log/mail.log

Troubleshooting Common Issues

Error Solution
SASL authentication failed Verify credentials in sasl_passwd and check file permissions (600)
Connection timed out Check firewall settings, ensure port 587 is open
Certificate verification failed Install ca-certificates package
Message size exceeds limit Increase message_size_limit in main.cf

Security Best Practices

  • Always use App Passwords instead of your main Gmail password

  • Enable two-factor authentication on your Gmail account

  • Set proper file permissions (600) on authentication files

  • Regularly monitor mail logs for suspicious activity

  • Keep your system and Postfix installation updated

Conclusion

Configuring Postfix to use Gmail SMTP provides a reliable and secure email solution for Ubuntu systems. By following proper authentication methods and security practices, you can ensure efficient email delivery while maintaining account security. Remember to use App Passwords for enhanced protection and monitor your configuration regularly.

Updated on: 2026-03-17T09:01:38+05:30

15K+ Views

Kickstart Your Career

Get certified by completing the course

Get Started
Advertisements