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:
- 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
Gmail
- Port: 465
- SMTP server: smtp.gmail.com
- SMTP Username: Your Gmail login (xxx@gmail.com or xxx@yourdomain.com)
- SMTP Password: Your Gmail password
- Usage of SSL: yes
iCloud
iCloud does not support SSL/TLS, onyl TLS with STARTTLS, so it can't be used with Dolibarr.
If this is fixed one day, setup would be:
- Server: smtp.mail.me.com
- 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.)
- Password: iCloud Mail SMTP password: Your iCloud Mail password or an app-specific password (with two-step authentication enabled)
- Port: iCloud Mail SMTP port: 587
- Use TLS: 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.