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.

ENABLED       = true
FROM          =
MAILER_TYPE   = sendmail
SENDMAIL_PATH = /usr/sbin/sendmail

SMTP version

ENABLED        = true
FROM           =
MAILER_TYPE    = smtp
HOST           =
USER           =
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