Forgejo has mailer functionality for sending transactional emails (such as registration confirmation). It can be configured to either use Sendmail (or compatible MTAs like Postfix and msmtp) or directly use SMTP server.
Directly use SMTP server as relay. This option is useful if you don’t want to set up MTA on your instance but you have an account at email provider.
[mailer] ENABLED = true FROM = firstname.lastname@example.org MAILER_TYPE = smtp SMTP_ADDR = mail.example.com SMTP_PORT = 587 IS_TLS_ENABLED = true USER = email@example.com PASSWD = `password`
Restart Forgejo for the configuration changes to take effect.
To send a test email to validate the settings, go to Forgejo > Site Administration > Configuration > SMTP Mailer Configuration.
For the full list of options check the Config Cheat Sheet.
Please note: authentication is only supported when the SMTP server communication is encrypted with TLS or
HOST=localhost. TLS encryption can be through:
- STARTTLS (also known as Opportunistic TLS) via port 587. Initial connection is done over cleartext, but then be upgraded over TLS if the server supports it.
- SMTPS connection (SMTP over TLS) via the default port 465. Connection to the server use TLS from the beginning.
- 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.
Note that Implicit TLS is recommended by RFC8314 since 2018.
sendmail command as mailer.
Note: For Internet-facing sites consult documentation of your MTA for instructions to send emails over TLS. Also set up SPF, DMARC, and DKIM DNS records to make emails sent be accepted as legitimate by various email providers.
[mailer] ENABLED = true FROM = firstname.lastname@example.org MAILER_TYPE = sendmail SENDMAIL_PATH = /usr/sbin/sendmail SENDMAIL_ARGS = "--" ; most "sendmail" programs take options, "--" will prevent an email address being interpreted as an option.
This page's content is available under the Apache-2.0 license. It is derived from this original source.