foster/forgejo
1
0
Fork 0
mirror of https://codeberg.org/forgejo/forgejo.git synced 2024-12-25 13:19:37 -05:00
Code Issues Wiki Activity
forgejo/docs/content/doc/usage/email-setup.en-us.md
zeripath 02a52d683b
Add warning to mailer documentation about authentication (#11563) 
* Add warning to mailer documentation about authentication

References #7966

Signed-off-by: Andrew Thornton <art27@cantab.net>

* As per @guillep2k and @mrsdizzie

* as per @mrsdizzie

Signed-off-by: Andrew Thornton <art27@cantab.net>

Co-authored-by: guillep2k <18600385+guillep2k@users.noreply.github.com>
2020-05-24 23:56:18 +01:00

2.1 KiB
Raw Blame History

date title slug weight toc draft menu
2019-10-15T10:10:00+05:00 Usage: Email setup email-setup 12 true false
sidebar
parent name weight identifier
usage Email setup 12 email-setup

Email setup

To use Gitea's built-in Email support, update the app.ini config file [mailer] section:

Sendmail version

Use the operating system’s sendmail command instead of SMTP. This is common on Linux servers.
Note: For use in the official Gitea Docker image, please configure with the SMTP version.

[mailer]
ENABLED       = true
FROM          = gitea@mydomain.com
MAILER_TYPE   = sendmail
SENDMAIL_PATH = /usr/sbin/sendmail

SMTP version

[mailer]
ENABLED        = true
FROM           = gitea@mydomain.com
MAILER_TYPE    = smtp
HOST           = mail.mydomain.com:587
IS_TLS_ENABLED = true
USER           = gitea@mydomain.com
PASSWD         = `password`

  • Restart Gitea for the configuration changes to take effect.

  • To send a test email to validate the settings, go to Gitea > Site Administration > Configuration > SMTP Mailer Configuration.

For the full list of options check the [Config Cheat Sheet]({{< relref "doc/advanced/config-cheat-sheet.en-us.md" >}})

  • Please note: authentication is only supported when the SMTP server communication is encrypted with TLS or HOST=localhost. TLS encryption can be through:
    • Via the server supporting TLS through STARTTLS - usually provided on port 587. (Also known as Opportunistic TLS.)
    • SMTPS connection (SMTP over transport layer security) via the default port 465.
    • Forced SMTPS connection with IS_TLS_ENABLED=true. (These are both known as Implicit TLS.)
  • This is due to protections imposed by the Go internal libraries against STRIPTLS attacks.

Gmail

The following configuration should work with GMail's SMTP server:

[mailer]
ENABLED        = true
HOST           = smtp.gmail.com:465
FROM           = example@gmail.com
USER           = example@gmail.com
PASSWD         = ***
MAILER_TYPE    = smtp
IS_TLS_ENABLED = true
HELO_HOSTNAME  = example.com