Skip to main content
Skip table of contents

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

SettingProperty NameDescription
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}.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.