Admin UI - Email Server Settings
XNAT relies on its mail servers to send messages to its users as well as to alert admins when certain events happen. In addition, a properly configured mail server is necessary for users to be able to get sent links to reset their password when they forget it.
If you do not have a local mail server, you may want to consider Using Gmail as your XNAT SMTP Server.
Settings
| Setting | Property Name | Description |
|---|---|---|
| Enable SMTP? | smtpEnabled | This switchbox controls whether you want to enable Simple Mail Transfer Protocol (SMTP), which is how XNAT sends email. If you disable this, then emails will not be sent. |
| Host | smtpHostname | This is the address of the SMTP server that you want XNAT to use to send mail. Your institution may have a mail server you want to use, or you can find the SMTP server information for your preferred email service (such as Gmail). |
| Port | smtpPort | This is SMTP port you want XNAT to use. |
| Username | smtpUsername | This is the username you want XNAT to use for accessing the SMTP server. For some servers, you can leave the username and password blank. If using Gmail, this will be your Gmail address. |
| Password | smtpPassword | This is the password you want XNAT to use for accessing the SMTP server. For some servers, you can leave the username and password blank. If using Gmail, you will need to get an application-specific password for XNAT so it can send email using your account. |
| Protocol | smtpProtocol | This is the protocol you want XNAT to use, which you will want to set to 'smtp' |
| SMTP Auth? | smtpAuth | This indicates whether the SMTP AUTH extension of SMTP should be used for sending email. Many mail servers require SMTP AUTH. |
| Start TLS? | smtpStartTls | If true, this enables switching to a connection that is protected by Transport Layer Security (TLS) before logging in to the email server. For some servers, such as Gmail, you will want to enable this. |
| SSL Trust | smtpSslTrust | This is a whitespace-separated list of trusted hosts. If set to '*', all will be trusted. If this is left blank, then trust will be based on certificates. |
| Email Prefix | emailPrefix | This is what you want to show up at the beginning of the Subject for all emails sent from XNAT. This is often the name of your site, or an abbreviation of it, and makes it easier for your users to see at a glance that they have received an email from your XNAT instance. |
Site-wide config properties can be accessed via REST at /xapi/siteConfig/values/{property-name}.
Site-wide config properties can be access programmatically in Velocity via $siteConfig.{property-name}.