aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorJames Liu <disposedtrolley@users.noreply.github.com>2023-01-02 13:52:36 +1100
committerGitHub <noreply@github.com>2023-01-02 10:52:36 +0800
commite61ce934bc4ce70214351d8b89eecd484b3f8bd8 (patch)
treebd82d604f37c0478a8182c99ca0f0eb9498a6d02 /docs
parentb994b2ea9c0fefbaceea5f2fbea750ed4b3afcb8 (diff)
downloadgitea-e61ce934bc4ce70214351d8b89eecd484b3f8bd8.tar.gz
gitea-e61ce934bc4ce70214351d8b89eecd484b3f8bd8.zip
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 <dev.lh@web.de>
Diffstat (limited to 'docs')
-rw-r--r--docs/content/doc/usage/email-setup.en-us.md9
1 files 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.