[Other doc versions]
Setting up Stash to use your SMTP mail server:
To configure a mail server for Stash, go to the administration area and click Mail server (under 'Settings'). See Supported platforms for the mail clients supported by Stash.
Complete the form and click Save.
|Hostname||The hostname of the mail server (for example "localhost" or "192.168.1.15").|
|Port||The port of the mail server (if unspecified, the port 25 will be used).|
|Username||The username to use to connect to the mail server.|
|Password||The password to use to connect to the mail server.|
Use either SMTP or SMTPS when connecting to the mail server.
When using SMTP, you can specify that:
See Securing email notifications below.
|Email from||Specifies the 'From' header in notification emails (for example: firstname.lastname@example.org).|
If you wish to set up the outgoing mail server as an anonymous user, simply leave the username and password fields empty. However, in Chrome, these fields may be auto-populated, leading to an error – as a workaround, try using a different browser.
Stash 3.6 and later versions support the following protocols:
Note that if you use either SMTP with STARTTLS, or SMTPS, and connect to a self-signed mail server, you may need to import the server's cert ificate and set up a custom cacerts file for Stash (just as you do for any outbound SSL/TLS connection to a self-signed server). See this Stash knowledge base article for information about how to do that.
If you wish to connect to a Gmail account for email notifications in Stash, refer to the Configuring the Mail Server to Use Gmail guide.
In particular, note that Gmail won't show images in the email because of the way that Google loads images on their servers. For Google Apps, a Stash administrator can solve the problem by adding the Stash domain name to a whitelist – see https://support.google.com/a/answer/3299041?hl=en for more information.