Setup EMails

Return to user
documentation index

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:

• 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.

Dolibarr option can manage the first case, the second one is not supported.

EMail used as sender for automatic emails

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

== Examples for common Mail server setup

=== iCloud

• iCloud Mail SMTP server address: smtp.mail.me.com
• iCloud Mail SMTP user name: Your iCloud Mail email address

(Do include the domain name—what follows "@" in your iCloud Mail address; if your iCloud Mail email address is "me@icloud.com", for instance, do use "me@icloud.com" as the user name.)

• iCloud Mail SMTP password: Your iCloud Mail password or an app-specific password (with two-step authentication enabled)
• iCloud Mail SMTP port: 587
• iCloud Mail SMTP SSL/TLS required: no
• iCloud Mail SMTP STARTTLS required: yes

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.