Users will learn how to configure the UniFi Controller to send email using a free Gmail account and the Gmail Simple Mail Transfer Protocol (SMTP) Server when no other suitable SMTP server is available and UniFi Cloud will not be used. This is needed for the Forgot Password? email to be sent.
NOTES & REQUIREMENTS:
Gmail is used for this work instruction, but other mail service providers can be used as long as the SMTP, port and username/password is known.
Important: Google may block sign-in attempts from some apps or devices, in which case you would receive an email stating that a sign-in attempt was blocked, mentioning devices that do not use modern security standards. Follow this work instruction to fix this issue. It is important to note that if your Google account has 2FA verification enabled, it will not allow you to fix this.
Table of Contents
The UniFi Controller relies on email to serve Forgot Password requests, invite administrators, and communicate device alerts.
If UniFi Cloud Access is enabled, the controller will automatically make use of the cloud services to send admin invitations (only). This will happen when "Enable Cloud Access" or "Invite to SDN" is checked on the admin invite itself. You still need to configure the SMTP settings for the controller to send most email messages (local account recovery and email alerts), and also to send admin invites without choosing "Enable Cloud Access" or "Invite to SDN".
If UniFi Cloud Access will not be enabled, it is important that a SMTP server be configured to facilitate email delivery - especially for Forgot Password requests, but also for email alerts and admin invites.
Steps: How to Set Up Gmail as SMTP Server
Step 1: Create a Gmail Account
Create a new Gmail Account, or use an existing one. Keep in mind emails sent by the UniFi Controller will appear to come from this email account.
Take note of the account credentials (email address and password).
You may also use a Google Apps account, as long as the Google Apps Domain Administrator has not disabled SMTP support. For more information on Google Apps SMTP Support, see https://support.google.com/a/answer/176600?hl=en
NOTE: As stated in this google support page, if you use 2-Step-Verification you might need to create an App password instead of using your regular Google password before being able to configure the SMTP settings for the controller.
Step 2: Enable SMTP Server Support
In the UniFi Controller, navigate to Settings > Controller > Mail Server section > SMTP Server and check "Enable mail server". Remember to click on Apply Changes when making configuration changes in the UniFi Controller.
Step 3: Configure SMTP Settings
Configure the Mail Server section as follows:
Enable SSL: Checked
Enable authentication: Checked
Username: Enter the full Gmail email address from Step 1 (including @gmail.com or @your_domain.com)
Password: Enter the account password from Step 1
Specify sender address: Unchecked
Testing & Verification
Enter a valid email address that you have access to in the text box labelled “Send test email to” and click Send. You should see a success message at the top-right corner of the browser screen, and within a few minutes you should receive a test email confirming the email was sent successfully.
NOTE: If the UniFi Controller shows a Success message when sending the test email, but the test email is not found in the target account's Inbox, be sure to check the All, Spam and Junk folders.