SmarterMail Help

General System Settings

Below are the configuration options available when viewing the General Settings section of SmarterMail. To access this section, log into SmarterMail as a System Administrator and click on General in the navigation pane.

Server Info

  • Hostname - The hostname of the server. Note: Hostnames should be in the format
  • Primary DNS IP - The IP address of the primary DNS server. If left blank, the DNS server information will be pulled from the the Windows Networking settings (recommended).
  • Secondary DNS IP - Enter the IP address of the secondary DNS server. If left blank, the DNS server information will be pulled from the the Windows Networking settings (recommended).

Login Display

Small businesses using SmarterMail on their own servers, or even companies using SmarterMail from their hosting provider, will benefit from the ability to customize the SmarterMail login page to add a company logo, provide additional branding text, or simply adjust the default �Login to SmarterMail� text to be more in line with an overall brand message. Note: System Administrators can allow Domain Administrators to override the custom login screen by editing the Domain and enabling Login Display Customization in the Features section.

  • Image for Login Screen - Upload an image, like a company logo, by dragging and dropping a file in the highlighted area or clicking to browse for a file (max file size of 3mb). Uploading an image using this upload control will host the image publicly on the server and enter the <img src="URL" /> tag in the HTML section. Note: Uploading an image here alone will NOT display the image on the login screen. The HTML must remain in the Login Page HTML section. This upload control can be used by those who don't have their logo publicly hosted or who wish the image source to point back to their mail server. Furthermore, regardless of the image uploaded, the image's source URL will remain the same; only one image may be hosted at a time.
  • Custom Login Text - Use this setting to customize the login page header to something more in line with an overall brand message. If Custom Login Text is left blank, SmarterMail's login page will show the default text "Welcome to SmarterMail".
  • Custom Title Text - Use this setting to customize the title of the login page to something more in line with an overall brand message. If Custom Title Text is left blank, SmarterMail's login page will show the default text of "SmarterMail" in the browser tab title. Note: Whe a system administrator is logged in, the custom title text will appear on all pages. If the login display for a domain is not set to default or overridden, users will see this text on the login page only, with their email address displayed as the browser title for all other pages.
  • Login Background - Use this option to select the background image(s) that displays on your login screen. Use the default images that come with SmarterMail, point to your own path on the server or select a solid color background. For custom images, the following image formats are supported: SVG, PNG, JPEG/JPG and GIF. Minimum size is dependent upon the image type being used. However, you can use 1920 x 1280 as a general guideline.
  • Login Page Language - Use this option to set the default language for the login page of SmarterMail. SmarterMail contains several pre-defined language packs in each installation, so the languages listed in the dropdown have accompanying language packs pre-installed and avaialable for use.
  • Check for Outdated Browser - When enabled, SmarterMail will check the version of the browser being used at the login page, and if it doesn't meet the minimum broswer requirements, the user will see a screen asking them to upgrade their browser. SmarterMail does have some requirements that modern browsers meet -- things like WebRTC support for video conferencing, support for AngularJS and other newer technologies -- that ensure the ideal experience when using the SmarterMail web client. While older browsers may work, current browsers are highly recommended.
  • Enable custom login page HTML - Check this box to enable the ability to use HTML to further modify the login screen to add additional text or adjust the layout.
  • Login Page HTML - Enter the custom HTML that will be used to further modify the login screen (in-line custom CSS can be used as well). Note: To include white space around the Image on Login Screen, the div id "companyinfo" must be included.

Custom Logout

  • Logout URL - The URL to which users are redirected when they log out of SmarterMail. By default, users are presented with the log in page for the mail server. If this should be different, a new URL can be added. Toggle the slider to the right to enable the Logout URL.
  • Domains can override Logout URL - Toggle the slider to the right to allow Domain Administrators to specify a Logout URL for their domain. If this option is not enabled, the option will not be visible to Domain Administrators.

Custom Help

  • Custom Help URL - Entering a full URL in this field will add a custom link to the Help menu that users can access in the SmarterMail interface. Administrators can link to a variety of things, including server-specific instructions for syncing, help resources, contact information, etc.
  • Custom Help Text - The hyperlink text for the custom URL in the Help menu.


Use this tab to specify the following settings:

  • Delete Server Stats (Months) - The length of time server stats should be kept before being deleted. By default, server stats are deleted after 13 months.
  • Delete Domain Stats After (Months) - The length of time domain stats should be kept before being deleted. By default, the domain stats are deleted after 13 months.
  • Delete User Stats After (Months) - The length of time user stats should be kept before being deleted. By default, the user stats are deleted after 13 months.


Generally, large mail providers will block messages without a valid Return-Path. This isn't normally an issue as most email flows FROM a valid user TO a valid user. However, some system messages can be sent from the mail server itself to a user -- a Password Reset email, for example. In these cases, most mail servers will use a general "Postmaster" account. In the past, using a generic "System Administrator" designation for these types of messages was enough to ensure that they were delivered. These days, with the rise of spam and malware, larger mail providers are no longer accepting that behavior: they require a valid email address to be associated to messages sent from the system.

Therefore, system administrators need to set up a valid email address for system messages (and, potentially, Event emails) sent at the user, domain and system level. This is handled by the Postmaster account that's set up for the server. This can be any email address, either set up locally or a remote email address, but it must be a valid address. If one is NOT provided, there is a very real possibility that system-level emails never reach their intended recipient.

If the address used is a local address, there won't be any issues with any system messages being delivered. Therefore, this is the best option. If an extneral email address is used, administrtors need to make sure that SPF and DNS records are set up correctly, or the SmarterMail server will need to be whitelisted. If no address is used, then email failures for system messages may result.

On the Postmaster card, the options are as follows:

  • Postmaster Mailbox - This is usually the mail server System Administrator's email address, or a generic system-level account (e.g., admininstrator@, postmaster@, etc.) as this is where errors in email processing are generally directed.
  • Postmaster delivery at domain level only - Select this option to use the domain-level postmaster address and avoid duplicate postmaster messages from being delivered.

File Storage

SmarterMail's file storage feature allows users to upload files to the server and share them via public links. One benefit of using file storage is that it reduces the stress on the server by keeping large files out of the spool. Note: Files uploaded to the server are counted toward the user's disk space allocation, so system administrators should encourage users to delete any unused files whenever possible.

  • Max File Size - The maximum size a file can be in order to be uploaded to the server.
  • Root Webmail URL - The base URL of any file stored and shared in file storage. By default, the base URL corresponds to the domain the mail server is set up on (i.e., If SmarterMail is configured on an external IP that allows a network address translation (NAT) to an external IP, the system administrator may need to modify the root URL.
  • Extension Blacklist - Use this section to select and list any file types that cannot be uploaded to the server via File Storage. System Administrators may want to limit the capabilites of users to upload certain file types, such as executables (.exe) or other file types that can possibly be used to cause problems on the server.


  • Incoming Extension Blacklist - This list allows you to limit the file types that are allowed INTO the mail server. For example, many email administrators won't allow executable files (EXE) as they can cause issues on the mail server, and possibly across an entire network. To add a blacklisted file type, simply type in the file extension, one per line. (E.g., .exe or EXE)
  • Outgoing Extension Blacklist - This list allows you to limit the file types that are users are allowed to send OUT OF the mail server. For example, many email administrators won't allow batch files (.BAT) as they can cause issues on the recipients' mail server, and possibly across their entire network. To add a blacklisted file type, simply type in the file extension, one per line. (E.g., .bat or BAT)


  • Spool Path - The full path in which messages are stored prior to delivery. If you are using a real-time virus scanner, this is the path that must be scanned in order to properly handle viruses.
  • SubSpools - SubSpools are within the spool path and allow SmarterMail to work around the NTFS limitation of 30,000 objects in an individual folder. SmarterMail will utilize subspools by evenly distributing mail among the subspools, allocating up to 10,000 messages per subspool. If the subspool count is set to 1, the Spool folder will be used. Note: If the subspool count is lowered, the old subspool folders will not be automatically deleted; however, you may manually delete the unused subspool folders if you wish. This design is to accommodate for situations where the subspool count is lowered while mail is still processing in those folders. (Default value is 10)
  • Delivery Delay (Seconds) - This number of seconds mail will be held in the spool before it is delivered. A delivery delay is beneficial when you are running a secondary service (such as a virus checker) that needs access to messages prior to delivery, as it provides ample time for the secondary service to interact with the message. By default, the delivery delay is 1 second.
  • Retry Intervals (Minutes separated by commas) - When the mail server is unable to contact the receiving server, the email attempting to be sent is held for a period of time before the mail server attempts to resend it. This is the time between retries. Users can specify multiple retry attempts to resend emails before it is bounced. By default, this is set to 4 attempts - at 15 min, 30 min, 60 min, and 90 min intervals.
  • DNS Errors Before Bounce- The maximum number of attempts SmarterMail should make before the message is bounced due to a DNS error. The most common cause of a DNS error is a misspelled domain. Limiting the number of attempts before DNS errors are bounced is beneficial because messages will not sit in the queue for long periods of time taking up processing on the mail server and possibly slowing the system down. This will be helpful to users because messages will be bounced sooner and will give users the opportunity to fix any mistakes and get a message resent. By default, the server will make 2 attempts. Note: Setting this at 1 retry can be dangerous if the DNS server fails or if there is a loss of Internet connectivity. To disable this feature, set the number of bounces equal to the number of retry intervals.
  • Notify Senders of Delay After (Attempts) - Sets the number of delivery attempts before the sender is notified that the email delivery is delayed. This can be beneficial as it lets the sender know that the mail server is still attempting to deliver the message but that the recipient has not received it yet. (Default value is 0.)
  • Max Local Delivery Threads - Enter the maximum number of messages that can be sent at one time to email addresses that are on the local server. If a message cannot be sent, the server's multi-threading capabilities will move on to the next message and eventually get back to the one it skipped. This action can save tremendous amounts of time when compared to some other mail servers that stall the spool if a message cannot be sent right away. (Default is 50)
  • Command Line File - Move the slider to the right to enable this option. Then enter the full path to an executable you wish to use to process incoming messages. Use %filepath as an argument to pass the path of the email file to the executable. It is allowable for the executable to delete the message to prevent delivery. Example: If you set this field to "c:\program files\myexe.exe %filepath", the program myexe.exe will be launched with the full path to the spool file as its first argument.
  • Command-Line Timeout (Seconds) - The number of seconds that the server will wait for information from the remote server. By default, the timeout is set to 5 seconds.


System Administrators can configure server-wide message footers that SmarterMail will append on all incoming and outgoing messages. Messages that a SmarterMail user forwards that already has a footer will not have the system footer appended as well. Although similar to signatures, message footers are typically used to convey disclaimers or provide additional information. For example, a system administrator may want every message to include a notice that the message was scanned for viruses or the text "Sent by SmarterMail."

  • Enable footer for all messages - Move the slider to the right to turn on the message footer for all incoming and outgoing messages. This setting does not need to be enabled to allow Domain Admins to override. If domain admins do override this setting and it�s enabled for all messages, emails will have the domain footer on outgoing messages but still have the system footer on incoming messages.
  • Apply to mailing lists - Move to slider to the right to enable this setting and append the message footer to mailing list messages. Note: Mailing lists have their own configurable footers. If a custom mailing list footer is already configured, enabling this option will append a second footer at the end of each message posted to the mailing list subscribers. Because this may be confusing for mailing list moderators and recipients, most administrators will choose to keep this option disabled.
  • Domains can override footer - Move the slider to the right to enable this setting and allow domain administrators to configure a unique message footer for their domain.
  • Footer - Use this section to create the message footer text. Clicking the edit icon will open a modal that includes an HTML-based editor, allowing admins to create footers that seamlessly fit into any email message. Note: The message footer does not support the use of variables.