Setup EMails

Help about screen: EMail setup

Menu path: Home -> Setup -> EMails

The EMails setup screen allows you to setup Dolibarr to send EMails and to test your setup.

= E-Mails setup parameters = This is explanation of all setup parameters:

Disable globally all emails sendings (test mode or demo)
Set this to No. If you set to yes (for a demo system for example), no more mail will be sent.

Method to send emails

 * The default method is PHP mail function. This means that Dolibarr use your PHP to send emails. This suppose your PHP setup is complete. If you don't know how to setup PHP for email sending, prefer next method.
 * If your email sending server needs authentication, or if you don't have permission or knowledge to setup your PHP, choose the second method: SMTP/SMTPS socket library.

Hostname or ip address of SMTP/SMTPS sending server
Name or IP address of the server that send mail. It is usually an name like smtp.xxx.zzz provided by your Internet Service Provider.

For example:
 * smtp.gmail.com
 * smtp.aol.com
 * smtp.free.fr
 * smtp.myprovider.com

Port of SMTP/SMTPS sending server
If the email sending server use the standard port (25), you can let the field empty.

Other examples:
 * 25 (SMTP standard)
 * 465 (SMTPS gmail)

SMTP Authentification ID
Visible if you have choose SMTP/SMTPS socket library as sending method. Put here your login.

SMTP Authentification Password
Visible if you have choose SMTP/SMTPS socket library as sending method. Put here your password.

Usage of TLS (SSL)
Some emails servers require encrypted communication (For example the SMTP server of Google smtp.gmail.com. It's SMTPS).

The only method that support this protocol is SMTP/SMTPS socket library. You must enable cryptography by setting this method if you need such encryption.

Note: SSL functions must be available in your PHP. If not, you probably forget to install the openssl module of PHP.

Note: There is 2 different types of SMTP secured encoding: Dolibarr option can manage the first case, the second one is not supported.
 * Sending SMTP protocol inside a crypted stream (SSL or non standard TLS). Server is often running on port 465.
 * Sending crypted data inside SMTP (TLS using STARTTLS). Server is often running on port 587.

EMail used as sender for automatic emails
EMail that will be used by Dolibarr as emails sender if sender is not explicitly defined.

= Actions =

Test server availability
This button is to test if you can communicate with the server. This allow you validate the parameter:
 * Hostname or ip address of SMTP/SMTPS sending server
 * Port of SMTP/SMTPS sending server
 * Usage of TLS (SSL)

Test send email
This button is to test what happens when you send an email with simple text content.

Test send email HTML
This button is to test what happens when you send an email with HTML content.