Generate Gmail App Password for SMTP relay #165

Open
opened 2026-11-11 17:10:29 +00:00 by rajames · 0 comments
Owner

Context

Google blocks plain-password SMTP authentication. An App Password (a 16-character token) is required for the namshi/smtp relay container.

Steps

  1. Go to https://myaccount.google.com/apppasswords while logged in as robert.allan.james@gmail.com
  2. App name: starshipos-smtp (or anything recognisable)
  3. Click Create — Google shows the password once; copy it immediately
  4. Set it in /opt/strshipos/.env:
    GMAIL_APP_PASSWORD=xxxx xxxx xxxx xxxx
    
  5. Restart the smtp container:
    docker compose -f /opt/strshipos/docker-compose.yml up -d smtp
    

Note

2-Step Verification must be enabled on the Google account before App Passwords become available.

Acceptance

Send a test from the relay container and confirm mail arrives in the inbox.

## Context Google blocks plain-password SMTP authentication. An App Password (a 16-character token) is required for the `namshi/smtp` relay container. ## Steps 1. Go to https://myaccount.google.com/apppasswords while logged in as `robert.allan.james@gmail.com` 2. App name: `starshipos-smtp` (or anything recognisable) 3. Click **Create** — Google shows the password once; copy it immediately 4. Set it in `/opt/strshipos/.env`: ``` GMAIL_APP_PASSWORD=xxxx xxxx xxxx xxxx ``` 5. Restart the smtp container: ``` docker compose -f /opt/strshipos/docker-compose.yml up -d smtp ``` ## Note 2-Step Verification must be enabled on the Google account before App Passwords become available. ## Acceptance Send a test from the relay container and confirm mail arrives in the inbox.
rajames added this to the v4.0.0-alpha.5: SDK milestone 2026-11-11 17:10:29 +00:00
Sign in to join this conversation.