Click Create — Google shows the password once; copy it immediately
Set it in /opt/strshipos/.env:
GMAIL_APP_PASSWORD=xxxx xxxx xxxx xxxx
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
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Context
Google blocks plain-password SMTP authentication. An App Password (a 16-character token) is required for the
namshi/smtprelay container.Steps
robert.allan.james@gmail.comstarshipos-smtp(or anything recognisable)/opt/strshipos/.env: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.