Open New Support Ticket 
How to Setup Gmail (Webmail) Email on Your VPS
Setting up Gmail for sending and receiving emails through your VPS (Virtual Private Server) can help you manage your emails more efficiently, particularly if you are running a website or service. This article walks you through the steps to configure your VPS to use Gmail’s SMTP (Simple Mail Transfer Protocol) and IMAP (Internet Message Access Protocol) servers, which will allow your server to send emails through Gmail and receive them on your preferred client or application.
Prerequisites
Before getting started, ensure you have the following:
- A running VPS (Linux-based) with root or sudo access.
- A Gmail account.
- Basic knowledge of using SSH and configuring server settings.
Step 1: Connect to Your VPS via SSH
First, you need to connect to your VPS using SSH. Open a terminal (Linux/macOS) or an SSH client (such as PuTTY for Windows).
Use the following command to connect:
ssh username@your_vps_ip
Replace
usernameyour_vps_ipStep 2: Install Required Packages
Ensure that your VPS has the required packages installed. Depending on your needs, you may be using Postfix (to send emails) and Dovecot (to retrieve emails using IMAP).
You can install both on Ubuntu with the following commands:
sudo apt update
sudo apt install postfix dovecot-imapd
Follow the prompts during the Postfix installation. When asked for the mail configuration type, select Internet Site.
Step 3: Configure Postfix to Use Gmail’s SMTP
Postfix needs to be configured to use Gmail’s SMTP server for outgoing emails. Open the Postfix configuration file:
sudo nano /etc/postfix/main.cf
Add or modify the following settings:
relayhost = [smtp.gmail.com]:587
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous
smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt
smtp_use_tls = yes
Step 4: Create the Gmail Authentication File
You need to create a file that stores your Gmail credentials for Postfix to authenticate with Gmail’s SMTP server. Open a new file:
sudo nano /etc/postfix/sasl_passwd
Add the following line, replacing
your-email@gmail.comyour-password[smtp.gmail.com]:587 your-email@gmail.com:your-password
Save and close the file.
Now secure the file by changing its permissions:
sudo chmod 600 /etc/postfix/sasl_passwd
Generate the database file needed by Postfix:
sudo postmap /etc/postfix/sasl_passwd
Step 5: Reload Postfix
After making these changes, reload Postfix for them to take effect:
sudo systemctl restart postfix
Step 6: Configure Dovecot for Gmail (IMAP)
Dovecot handles retrieving emails from your Gmail account. Open the Dovecot configuration file:
sudo nano /etc/dovecot/conf.d/10-auth.conf
Uncomment the following line:
disable_plaintext_auth = no
Now open the file that handles SSL configurations:
sudo nano /etc/dovecot/conf.d/10-ssl.conf
Ensure that SSL is enabled by setting:
ssl = required
Save and close the file, then restart Dovecot:
sudo systemctl restart dovecot
Step 7: Enable Less Secure Apps in Gmail
Gmail requires you to enable access for less secure apps if you are not using OAuth. To enable it:
- Go to your Gmail Security Settings.
- Scroll down to the “Less secure app access” section.
- Toggle the setting to allow access.
Alternatively, if you have two-factor authentication enabled, you’ll need to create an App Password under your Google account settings and use this instead of your regular Gmail password.
Step 8: Testing Email Sending and Receiving
You can test your configuration by sending an email directly from your VPS using the
mailsudo apt install mailutils
Then send a test email:
echo "This is a test email from my VPS" | mail -s "Test Email" your-email@gmail.com
Check your Gmail inbox to ensure you received the email. You can also verify that you can receive emails through Dovecot.
Step 9: Setup Gmail Webmail Client (Optional)
If you want to configure Gmail as a webmail client on your VPS, you can install webmail software like Roundcube or Rainloop, which provides a web-based interface for handling your email. This is helpful if you want a simple, user-friendly way to manage your Gmail emails directly from your VPS.
Installing Roundcube (as an example):
- Install necessary PHP and web server dependencies:
sudo apt install apache2 php php-mbstring php-xml php-mysql
- Download and install Roundcube:
sudo apt install roundcube roundcube-mysql
- Follow the on-screen instructions to configure Roundcube, and link it to your Gmail account via IMAP and SMTP.
Conclusion
By following this guide, you’ve successfully set up Gmail (webmail) on your VPS. You can now send and receive emails via your VPS using Gmail’s SMTP and IMAP servers. Whether you are setting up email for a small project or using it to manage business communications, this approach provides flexibility, reliability, and the convenience of using Gmail for email handling.
