The Mail Settings app is used for two purposes:
- To set the primary mail domain and hostname for ClearOS.
- To configure outbound mail settings to make sure system-generated e-mail alerts are delivered.
If your system does not have this app available, you can install it via the Marketplace.
You can find this feature in the menu system at the following location:
There are two primary mail settings needed for a ClearOS system. The Mail Domain is the default domain used by mail services:
- Outbound e-mail default domain
- SMTP services (if installed)
- POP/IMAP servers (if installed)
It is the “example.com” bit of the email addrss email@example.com.
The Mail Hostname is the default hostname used by mail services. For example, the SMTP Server (if installed) will reply to other mail servers with this hostname.
The Mail Notification settings is a tool to configure outbound mail for system-generated mail alerts.
The hostname of the SMTP server to connect to.
The port to used to send the initial connection request on. SMTP usually uses port 25, but the app also supports using SMTPS (SMTP with SSL) on port 465.
Encryption protocol to use when connecting to the host server. Use TLS for SMTPS on port 465. STARTTLS on port 587 is not supported.
A valid username to authenticate to the server.
A valid password to authenticate to the server.
The default sender address to use for system generated outbound mail.
Once you have configured the mail settings, it is time to ensure e-mails can get through successfully:
- Enter your e-mail address into the Test E-mail box
- Click on
If a successful connection and authentication (if required) is made, you will receive a notification that the test was successful. If the connection could not be made or if authentication using the settings provided failed, you need to go back and check your settings and then repeat the test.
Local SMTP Server
If you are running a local ClearOS [SMTP Server]] on the same server, you can leave the default in place (for example, port 25 at localhost). Keep in mind, this assumes that your local mail server is either:
- relaying directly and your ISP does not filter/block SMTP (port 25) traffic
- relaying through your ISP's SMTP servers
- configured to relay through an alternative (possibly non-standard port) relay service
Google Mail (Gmail)
With a valid Gmail account, one can easily set up the this app to relay through Google's SMTP server. Here is an example for a user with a Gmail account of “firstname.lastname@example.org”.
- SMTP Hostname: smtp.gmail.com
- SMTP Port: 465
- Encryption: TLS
- SMTP Username: email@example.com
- SMTP Password: the_password