Configuring SMTP with Gmail for digiRunner

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

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

A: To use a personal Gmail account for SMTP services in digiRunner, you cannot use your standard login password. Instead, you must generate and use a Google App Password.

Follow these steps to configure your environment correctly:

1. Generate a Google App Password

1. 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 a mandatory prerequisite.

1. 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.

1. 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-digit 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 upon the first connection attempt. You must acknowledge this alert and verify the activity to unblock the service. Once verified, emails should send normally.