Configuring SMTP with Gmail for digiRunner

Q: My regular Gmail password isn't working. How do I set up Gmail as the SMTP provider for digiRunner?

A: To use a personal Gmail account for SMTP in digiRunner, your regular login password will not work. You must generate a Google App Password instead. Follow these steps:

1. Generate a Google App Password

Enable 2-Step Verification

• Log in to your Google Account and navigate to Security on the left menu.

• Ensure 2-Step Verification is turned On. This is mandatory.

Create the App Password

• In the search bar at the top of the Security page, type "App passwords", and select the option.

• You may be asked to verify your identity by entering your password again.

• Enter a recognizable name for the app (e.g., "digiRunner"), and click Create.

Copy the Password

• A 16-character password will appear. Copy it immediately and remove any spaces.

2. Configure digiRunner Settings

Log in to the digiRunner console and navigate to System Configs > Setting. Update the following parameters:

Key	Value	Note
SERVICE_MAIL_AUTH	true
SERVICE_MAIL_ENABLE	true
SERVICE_MAIL_FROM	[email protected]	Enter your full Gmail address
SERVICE_MAIL_HOST	smtp.gmail.com
SERVICE_MAIL_PASSWORD	xxxxxxxxxxxxxxxx	Paste the 16-character App Password (remove spaces)
SERVICE_MAIL_PORT	587
SERVICE_MAIL_STARTTLS_ENABLE	true
SERVICE_MAIL_USERNAME	[email protected]	Enter your full Gmail address
SERVICE_MAIL_X_MAILER	digiRunner	Customizable identifier

3. Final Verification

• Save the settings and trigger a test email.

Important: Google may send a security alert on the first connection attempt. You must acknowledge this alert and verify the activity to unblock the service. Once verified, emails should send normally.

Keywords: SMTP Setup, Gmail Configuration, App Password, digiRunner Email Settings, Sending Failure