Jump to >

E-Mail Settings

Review Board provides a lot of options for customizing how and when e-mails are sent. You can control the types of e-mails that get sent out to your users, how those e-mails are generated, and what server is used to send them.

See Working with E-Mail for details on how Review Board sends e-mail, and how you can customize these settings to avoid mail delivery problems.

E-Mail Notification Settings

  • Send e-mails for review requests and reviews:

    If enabled, e-mails will be sent out whenever a review request is posted or updated, or when reviews and replies are posted.

    See E-Mail and Review Groups for more information.

  • Send e-mails when review requests are closed:

    If enabled, e-mails will be sent out whenever a review request has been closed/discarded.

  • Send e-mails to administrators when new users register accounts:

    If enabled, e-mails will be sent to the system administrator whenever a new user account has been registered, helping administrators on-board new users or catch suspicious activity.

  • Send e-mails to users when they change their password:

    If enabled, e-mails will be sent to users any time they change their password. For password-based authentication setups, this can help users confirm that their password change went through successfully, and can also catch any account hijacking.

  • Send e-mails when new users register an account:

    If enabled, e-mails will be sent to the administrator every time a new user signs up to the site. This is useful for open source projects that are interested in new user signups.

E-Mail Delivery Settings

  • Default From address:

    The default e-mail address that e-mails are sent from. The Sender e-mail header will be used to make e-mails appear to come from the user causing the e-mail to be sent. By using the Sender header for this instead of From, there’s less risk that e-mail clients will consider the e-mails to be malicious or spam. This may require a proper DKIM setup.

    This defaults to noreply@<servername>.

  • Use the user’s From address:

    Controls which From address is use for outgoing e-mails.

    If set to Auto, then any new e-mails sent out will use the sending user’s own e-mail address only if there’s no risk of a DMARC record quarantining the e-mail. If there is a risk, then the default From address will be used instead.

    If set to Always, then the user’s own e-mail address will always be used, without needing to perform a record lookup first. This can speed up sending, but at the risk of a mail server or client flagging the e-mail as suspicious.

    If set to Never, then the default From address will always be used.

  • Enable “Auto-Submitted: auto-generated” header:

    Configures whether this header will be attached to any outgoing e-mails. This can be turned off if using a mailing list that reject e-mails containing this header.

E-Mail Server Settings

  • Mail server:

    The SMTP mail server used for outgoing e-mails. This defaults to localhost.

  • Port:

    The SMTP mail server port. This defaults to 25.

  • Username:

    The username needed to connect to the outgoing SMTP mail server, if any. This is optional and depends on the mail server configuration.

  • Password:

    The password needed to connect to the outgoing SMTP mail server, if any. This is optional and depends on the mail server configuration.

  • Use TLS for authentication:

    If enabled, TLS is used for mail server authentication. This is more secure, but requires TLS support on the mail server.

  • Send a test e-mail after saving:

    Enable this to send a test e-mail address to yourself after saving the form. This can help verify that your e-mail setup is correct.