Support Articles

Gmail Account Settings for MadgeTech 4

Posted on

Configuring an email account in MadgeTech 4 serves several useful purposes. An outgoing email account can be used by MadgeTech 4 and MadgeTech 4 Secure to send email and text message alerts for alarms and workflows. MadgeTech 4 Secure also requires access to an email account in the creation of new users and to allow users and administrators to reset passwords.

To use a Gmail account to send outgoing emails from MadgeTech 4, the Gmail account must be configured to use Two-Factor Authentication, and an “App Password” must be generated in the Gmail account to be used in the MadgeTech 4 email settings.

To use a Gmail account for outgoing email in MadgeTech 4, navigate to File–>Options–>Email settings in MadgeTech 4 and enter the following settings:
Configuration type: SMTP
Server address: smtp.gmail.com
Port: 587
From email: Gmail address (ex: [email protected])
Security: Check “Use SSL/TLS” box
Username: Gmail address without the “@gmail” domain (ex: user)
Password: An “App Password” must first be generated in the Gmail account (see below).

It is recommended (but not required) that the following steps be performed on the PC running MadgeTech 4, to allow for easier cutting and pasting of the app password.

Enable Two-Factor Authentication for a Gmail Account :
(If two-factor authentication is already enabled, skip to the next section)
1. Open Gmail account in a Web browser
2. Click on the Google user icon and select “Manage your Google Account”
3. Select “Security” on the account management page
4. Select “Two Step Verification”
5. Click on “Get Started”
6. Enter Gmail password
7. Verify phone number that will be used for authentication. Choose “Text Message” or “Phone Call” and click “Next.”
8. Enter the code received from Google and click “Next”
9. Select “Turn On”
10. Click the back arrow next to “2-Step Verification” to return to the Security menu.

With Two-Factor Authentication enabled, Google will send a code to the entered phone number when a user attempts to log into the Gmail account. This code will be required to log in.

Generate an “App Password” in Gmail that can be used by MadgeTech 4:
(If continuing after enabling Two-Factor Authentication, skip to step 5)
1. Open Gmail Account in a Web browser
2. Click on Google user icon and select “Manage your Google Account”
3. Select “Security” on the account management page
4. Ensure Two-Factor Authentication is enabled. If not, use above steps to enable Two-Factor Authentication.
5. Select “App Passwords”
6. Enter Gmail Password and click “Next”
7. In “Select App” dropdown, select “Mail”
8. In “Select Device” dropdown, select “Other (“Custom name”)
9. Type “MadgeTech 4” in the text field and click “Generate”
10. The app password will be generated. Select the password, then use “CTRL-C” to copy, and “CTRL-V” to paste the password in the “Password” field in the MadgeTech 4 email settings.
11. Click “Done” in the “Generate app password” window

After completing the setup, click “Test Email Settings” in the MadgeTech 4 email settings menu, and enter an email address to generate a test email. A message should appear stating that “The test email was sent successfully,” and an email should be sent to the entered email address. If you receive an error, you will need to correct your email settings. For additional assistance, contact [email protected]

About Chris Morse: