From e61ce934bc4ce70214351d8b89eecd484b3f8bd8 Mon Sep 17 00:00:00 2001 From: James Liu Date: Mon, 2 Jan 2023 13:52:36 +1100 Subject: [PATCH] Update Gmail mailer configuration (#22291) This PR updates the `[mailer]` configuration snippet for Gmail: - The `HELO_HOSTNAME` isn't required. - The `USER` must not include the @gmail domain. - `HOST` needs to be supplied, and the SMTP port number needs to be appended to the URL. I also added a note about the requirement to use App passwords instead of your Google account password directly. Co-authored-by: delvh --- docs/content/doc/usage/email-setup.en-us.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/content/doc/usage/email-setup.en-us.md b/docs/content/doc/usage/email-setup.en-us.md index 05cc19c134..6d6b18786c 100644 --- a/docs/content/doc/usage/email-setup.en-us.md +++ b/docs/content/doc/usage/email-setup.en-us.md @@ -76,12 +76,15 @@ The following configuration should work with GMail's SMTP server: ```ini [mailer] ENABLED = true +HOST = smtp.gmail.com:465 ; Remove this line for Gitea >= 1.18.0 SMTP_ADDR = smtp.gmail.com SMTP_PORT = 465 -FROM = example@gmail.com -USER = example@gmail.com +FROM = example.user@gmail.com +USER = example.user PASSWD = *** MAILER_TYPE = smtp IS_TLS_ENABLED = true -HELO_HOSTNAME = example.com ``` + +Note that you'll need to create and use an [App password](https://support.google.com/accounts/answer/185833?hl=en) by enabling 2FA on your Google +account. You won't be able to use your Google account password directly.