Skip to main content

Setting up SMTP with Google / Gmail

Updated over 2 weeks ago

update needed

Issue Description

Integrate with Google Mail as the SMTP server with Jamf Pro.

Notes:

  • Rewritten 3/25/2020 due to changing requirements on Gmail's side

  • If you've already set up SMTP with Jamf Pro by using Google's Less Secure Apps (or LSA) functionality, it may have stopped communicating with Google properly.

  • The following method of configuring SMTP has been confirmed by Google Support to be unaffected by the LSA deprecation schedule. More information is available on Googles blog: Link to blog post

Troubleshooting Steps

Part 1: App-Specific Password Setup Procedure for Google Workspace

  1. Log into https://myaccount.google.com with the account you wish to send email from in Jamf Pro

  2. Click Security from the left navigation menu

  3. Click 2-Step Verification to start the setup process.
    Note: If 2-Step Verification is already enabled, skip to step 8.

  4. Click the Get Started button.

  5. Follow the prompts to set up a phone number or use the Gmail app for Google prompts

  6. After setting up 2-Step Verification, visually verify that what you've set up is listed under "Available second steps"

  7. Click the back arrow to return to the Security page.

  8. Click App passwords

  9. Click Select app and choose Other (Custom name)

  10. Provide a name for the app you are connecting (example: Jamf Pro) and click the Generate button

  11. Copy the generated app password that you are presented with. Save the password somewhere safe. It is not retrievable after this prompt.

  12. Click "Done"

Notes from Google about App Passwords:

  • App passwords are revoked after a password change

    • To help protect your account, your app passwords are revoked when you change your Google Account password. You can always create a new app password to continue using an app with your Google Account.

  • If you forgot your App Password

    • Every App Password is only used once. You can always generate a new App Password whenever you need one, even for a device or application you've authorized before.

Part 2: Setting up SMTP in Jamf Pro

  • Settings > System Settings > SMTP Server

  • Server: smtp.gmail.com

  • Port: 465

  • Encryption: SSL

  • Connection Timeout: Default (5 seconds)

  • Sender Display Name: Whatever you'd like to see in the inbox from Jamf Pro messages

  • Sender Email Address: Gmail/Google account email address

  • Requires Authentication: Yes/Checked

  • Username: Same Gmail/Google account email address from Sender Email Address

  • Password: Paste your generated app password here

  • Verify Password: Paste your generated app password here

Part 3: Confirming the Setup
Use the "Test" button to send a test e-mail using the SMTP configuration.

Did this answer your question?