Installing ONLYOFFICE Mail for Docker on a local server

ONLYOFFICE Mail is a full-featured mail server solution developed on the base of the iRedMail package, containing the following components: Postfix, Dovecot, SpamAssassin, ClamAV, OpenDKIM, Fail2ban.

Integrated with ONLYOFFICE Workspace, ONLYOFFICE Mail allows you to:

• connect your own domain name;
• create mailboxes;
• add aliases for each mailbox;
• create mailbox groups.

This guide will show you how to install ONLYOFFICE Mail Docker version to your machine.

Before you start installation of ONLYOFFICE Mail, you need to link your computer where ONLYOFFICE Mail is going to be installed with the domain selected for the mail server. We recommend that you select a name like mx.yourdomain.com for the A record of your mail server computer. This means that the A record in your Domain Name System (DNS) must point to the IP address of the computer where ONLYOFFICE Mail will be installed and the Pointer (PTR) record on this computer must resolve the computer IP address to a fully-qualified domain name (FQDN) as an opposite to what A record does.

To verify the correctness of the settings for the A record the following command is used:

dig -t A mx.yourdomain.com

If everything is correct you should see the output which contains lines like these among the others:

...;; ANSWER SECTION:
mx.yourdomain.com.  IN  A   {your IP address}...

Instead of {your IP address} the real IP address of the server will be shown.

The PTR record is checked with another command:

dig -x {your IP address}

It should return the output which contains lines like these among the others:

...;; ANSWER SECTION:{your IP address}   IN  PTR mx.yourdomain.com....

Once you make sure that all settings are correct, you can proceed to the next steps.

If you do not want to set everything manually, you can install ONLYOFFICE Mail automatically using our Docker script. You can download the script using our site download page. Or the direct download link can be used, if it is more convenient for you:

wget https://download.onlyoffice.com/install/workspace-install.sh

Once the download is finished, run the following command to install ONLYOFFICE Mail:

bash workspace-install.sh -ics false -ids false -icp false -ims true -md yourdomain.com -es true

If you prefer to have full control of what and how is being installed, you can run the installation in manual mode. To do that follow the steps below.

Installing prerequisites

docker_OPTS="--dns 8.8.8.8"

sudo docker network create --driver bridge onlyoffice

Installing MySQL

echo "[mysqld]
sql_mode = 'NO_ENGINE_SUBSTITUTION'
max_connections = 1000
max_allowed_packet = 1048576000
group_concat_max_len = 2048" > /app/onlyoffice/mysql/conf.d/onlyoffice.cnf

echo "ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'my-secret-pw';
CREATE USER IF NOT EXISTS 'onlyoffice_user'@'%' IDENTIFIED WITH mysql_native_password BY 'onlyoffice_pass';
CREATE USER IF NOT EXISTS 'mail_admin'@'%' IDENTIFIED WITH mysql_native_password BY 'Isadmin123';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%';
GRANT ALL PRIVILEGES ON *.* TO 'onlyoffice_user'@'%';
GRANT ALL PRIVILEGES ON *.* TO 'mail_admin'@'%';
FLUSH PRIVILEGES;" > /app/onlyoffice/mysql/initdb/setup.sql

sudo docker run --net onlyoffice -i -t -d --restart=always --name onlyoffice-mysql-server \
 -v /app/onlyoffice/mysql/conf.d:/etc/mysql/conf.d \
 -v /app/onlyoffice/mysql/data:/var/lib/mysql \
 -v /app/onlyoffice/mysql/initdb:/docker-entrypoint-initdb.d \
 -e MYSQL_ROOT_PASSWORD=my-secret-pw \
 -e MYSQL_DATABASE=onlyoffice \
 mysql:8.0.29

CREATE USER 'mail_admin'@'localhost' IDENTIFIED BY 'Isadmin123';
GRANT ALL PRIVILEGES ON * . * TO 'mail_admin'@'%' IDENTIFIED BY 'Isadmin123';
FLUSH PRIVILEGES;

Installing ONLYOFFICE Mail

After you have everything ready, execute the following command:

sudo docker run --init --net onlyoffice --privileged -i -t -d --restart=always --name onlyoffice-mail-server -p 25:25 -p 143:143 -p 587:587 -p 8081:8081 \
 -e MYSQL_SERVER=onlyoffice-mysql-server \
 -e MYSQL_SERVER_PORT=3306 \
 -e MYSQL_ROOT_USER=root \
 -e MYSQL_ROOT_PASSWD=my-secret-pw \
 -e MYSQL_SERVER_DB_NAME=onlyoffice_mailserver \
 -v /app/onlyoffice/MailServer/data:/var/vmail \
 -v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver \
 -v /app/onlyoffice/MailServer/logs:/var/log \
 -h yourdomain.com \
 onlyoffice/mailserver

Where yourdomain.com is your mail server hostname.

In this case the mail server will ensure the mail delivery to internal addresses hosted on this server.

Storing data outside containers

All the data are stored in the specially-designated directories, data volumes, at the following location:

• /var/log for ONLYOFFICE Mail logs
• /var/lib/mysql for MySQL database data
• /var/vmail for mail storage
• /etc/pki/tls/mailserver for certificates

To get access to your data located outside the container, you need to mount the volumes. It can be done by specifying the -v option in the docker run command.

sudo docker run --privileged -i -t -d -p 25:25 -p 143:143 -p 587:587 -p 8081:8081 \
        -v /app/onlyoffice/MailServer/logs:/var/log  \
        -v /app/onlyoffice/MailServer/mysql:/var/lib/mysql  \
        -v /app/onlyoffice/MailServer/data:/var/vmail  \
        -v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver -h yourdomain.com onlyoffice/mailserver

Storing the data on the host machine allows you to easily update ONLYOFFICE Mail once the new version is released without losing your data.

Configuring Docker image

To ensure the mail delivery to internal addresses as well as addresses of external servers you need to get your own domain name and configure a DNS server.

The following DNS records are required:

• A record (used to point a domain to the IP address of the host where this docker image is deployed).
• Pointer (PTR) record or a reverse DNS record (used to map a network interface (IP) to a hostname).

sudo docker run --privileged -i -t -d -p 25:25 -p 143:143 -p 587:587 \
-v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver -h yourdomain.com onlyoffice/mailserver

Where yourdomain.com is your mail server hostname.

Available configuration parameters

Below is the complete list of parameters that can be set using environment variables.

• STORAGE_BASE_DIR: The path to the mail store. Defaults to /var/vmail.
• FIRST_DOMAIN: The first virtual domain, where the postmaster address will be hosted. This domain should not coincide with the primary mail server domain. Defaults to mailserver.onlyoffice.com.
• DOMAIN_ADMIN_PASSWD: The postmaster password. The default postmaster address is postmaster@mailserver.onlyoffice.com.

ONLYOFFICE Mail is a part of ONLYOFFICE Workspace that comprises also ONLYOFFICE Docs, ONLYOFFICE Control Panel and ONLYOFFICE Community Server. In case you want to install all of them and integrate with each other, read these instructions.

Alternatively, you can use an automatic installation script to install the whole Workspace at once. For the mail server correct work you need to specify its hostname yourdomain.com.

STEP 1: Download the installation script file

Execute the following command:

wget https://download.onlyoffice.com/install/workspace-install.sh

STEP 2: Install Workspace

Run the following command to do that:

bash workspace-install.sh -md yourdomain.com