@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.) hq.recaptime.dev/wiki/Phorge
phorge phabricator

Diviner: Configuring Outbound Mail: Remove incorrect Gmail references

Summary:
Configuring SMTP for Gmail as described will trigger
"535-5.7.8 Username and Password not accepted. Learn more at 535 5.7.8 https://support.google.com/mail/?p=BadCredentials"
GMail only supports OAuth and 2FA/App Passwords these days; the "less secure apps" option (which would be needed for the described SMTP setup) has been removed.

Test Plan:
Follow the docs; set up `cluster.mailers` config setting in Phorge; run `./bin/mail send-test --to admin --subject subject < ~/foo` and fail.
Optionally, watch https://www.youtube.com/watch?v=Y_u5KIeXiVI for your personal corporate excitement.

Reviewers: O1 Blessed Committers, valerio.bozzolan

Reviewed By: O1 Blessed Committers, valerio.bozzolan

Subscribers: tobiaswiese, valerio.bozzolan, Matthew, Cigaryno

Differential Revision: https://we.phorge.it/D25911

+3 -4
+3 -4
src/docs/user/configuration/configuring_outbound_email.diviner
··· 21 21 | SendGrid | Medium | Cheap | Yes | Email | | 22 22 | Twilio | Easy | Cheap | No | SMS | Recommended | 23 23 | Amazon SNS | Easy | Cheap | No | SMS | Recommended | 24 - | External SMTP | Medium | Varies | No | Email | Gmail, etc. | 24 + | External SMTP | Medium | Varies | No | Email | | 25 25 | Local SMTP | Hard | Free | No | Email | sendmail, postfix, etc | 26 26 | Custom | Hard | Free | No | All | Write a custom mailer. | 27 27 | Drop in a Hole | Easy | Free | No | All | Drops mail in a deep, dark hole. | ··· 360 360 | Inbound | Requires Configuration 361 361 |---------| 362 362 363 - You can use this adapter to send mail via an external SMTP server, like Gmail. 363 + You can use this adapter to send mail via an external SMTP server. 364 364 365 365 To use this mailer, set `type` to `smtp`, then configure these `options`: 366 366 ··· 368 368 - `port`: Optional int. The port to connect to on your SMTP server. 369 369 - `user`: Optional string. Username used for authentication. 370 370 - `password`: Optional string. Password for authentication. 371 - - `protocol`: Optional string. Set to `tls` or `ssl` if necessary. Use 372 - `ssl` for Gmail. 371 + - `protocol`: Optional string. Set to `tls` or `ssl` if necessary. 373 372 - `message-id`: Optional bool. Set to `false` if Phorge will not be 374 373 able to select a custom "Message-ID" header when sending mail via this 375 374 mailer. See "Message-ID Headers" below.