lonely written words—are all you’ve got”

—Virginia Shea

“communication happens when I know you know what I know”


SMTP Server

Certain events can trigger email notifications to JSS administrators. Events includes Restricted Software violations, Smart Group changes, Policy errors, Licensed Software overages and more. Before it can send these email notificagtions, you must configure your JSS with the address of an outgoing mail (SMTP) server. Depending on your organization’s SMTP server settings, you may also need to provide credentials of a sending account.


 Configure outgoing server settings
 Determine sender settings
 Enter authentication settings
 Test connection settings

Unconfigured SMTP Server

Configure outgoing mail server settings

Practically all organizations use email today. Some host their own mail servers internally and others pay for mail hosting services such as Gmail and Office 365. Your mail services administrator will need to provide the correct settings to send or relay messages from the JSS to administrators.

To configure an outgoing connection, you need at minimum:

  • Server address: DNS or IP address of an SMTP server
  • SMTP port number: Port number specific to the type of encryption the server requires for receiving your messages (typically 25, 465 or 587)
  • Encryption type: The specific protocol for encryption (none, SSL or TLS)

If the JSS is connected to a slow Internet connection then you may need to increase the Connection Timeout. This is the length of time the JSS will wait for a response from the SMTP server before considering the connection failed. Leave the default five second timeout alone unless you experience intermittent failures.

Determine sender settings

You can also send email notifications to Mac and iOS users (your internal customers). They will have no idea who “JAMF Software Server” is and why it is sending them mail. Consider changing the Sender Display Name to something your users will recognize such as “Your Company IT Services” or “Help Desk”.

The JSS also sends mail with a return email address. Your users may recognize the Sender Display Name you’ve selected but may have a question about the message. They will naturally click the Reply button to ask and send their questions. Set the Sender Email Address to either a “noreply” address such as noreply-itservices@talkingmoose.net or a support address used by your Help Desk for opening tickets.

Enter authentication settings

Generally, internal SMTP relay servers that will allow sending mail over port 25 require no authentication.

However, if you don’t have access to an internal relay server you can authenticate to your outgoing mail server with credentials for a mail account by enabling Requires Authentication and entering the account’s username and password.

Ideally, this account would be another service account dedicated to sending mail on behalf of the JSS and its password would never expire. Don’t use a personal mail account. They typically require routine password changes and are disabled when the user leaves the organization.

Click the Save button or press “Control + s” for “save” when done.

Configured SMTP Server

Test connection settings

Once settings for an SMTP server are configured and saved, click the Test button at the bottom of the SMTP Server settings page to test the connection. If you’re logged in to your own JSS account the JSS will pre-populate the Recipient email address with the address for your account.

Click the Test button. A successful connection displays “A test message was successfully sent” below the Test button and you should receive a JSS Test message in your Inbox within a few seconds to a few minutes depending on the speed of your mail server.

A test message was successfully sent.

If you’ve incorrectly configured your SMTP settings, you’ll receive “Error sending message” notification below the Test button.

Error sending message