Updating ONLYOFFICE Mail integrated with ONLYOFFICE Groups

Step 1: Check if all the external data storage folders are mounted

Make sure that all the container volumes used to store ONLYOFFICE Mail data are mounted using the following command:

sudo docker inspect --format='{{range $p,$conf:=.HostConfig.Binds}}{{$conf}};{{end}}' {{MAIL_SERVER_ID}}

where {{MAIL_SERVER_ID}} stands for the ONLYOFFICE Mail container name or ID.

docker ps -a

You can backup the mounted folders located on the host machine, as a precaution:

• /app/onlyoffice/MailServer/logs
• /app/onlyoffice/MailServer/mysql
• /app/onlyoffice/MailServer/data
• /app/onlyoffice/MailServer/data/certs

sudo docker cp {{MAIL_SERVER_ID}}:var/log /home/user/Backup/MailServer/log
sudo docker cp {{MAIL_SERVER_ID}}:var/lib/mysql /home/user/Backup/MailServer/mysql
sudo docker cp {{MAIL_SERVER_ID}}:var/vmail /home/user/Backup/MailServer/vmail
sudo docker cp {{MAIL_SERVER_ID}}:etc/pki/tls/mailserver /home/user/Backup/MailServer/mailserver

Step 2: Remove the current container

sudo docker rm -f {{MAIL_SERVER_ID}}

where {{MAIL_SERVER_ID}} stands for the ONLYOFFICE Mail container name or ID.

Step 3: Remove the current image

The image used to install ONLYOFFICE Mail also needs to be removed, otherwise it will be used to install it anew and no upgrade will happen:

sudo docker rmi -f $(sudo docker images | grep onlyoffice/mailserver | awk '{ print $3 }')

Step 4: Run the new ONLYOFFICE Mail image with the same map paths

Create a network for Docker containers if it had not been created for the previous version:

docker network create --driver bridge onlyoffice

Run the new ONLYOFFICE Mail image:

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

Where yourdomain.com is your ONLYOFFICE Mail hostname.

Make sure that you run the new image with the folder paths mapped exactly as they had been mounted before you deleted ONLYOFFICE Mail image, otherwise the data stored in these folders will not be picked up automatically.

sudo mkdir -p /app/onlyoffice/MailServer/logs && sudo cp -a /home/user/Backup/MailServer/log/. $_
sudo mkdir -p /app/onlyoffice/MailServer/mysql && sudo cp -a /home/user/Backup/MailServer/mysql/. $_
sudo mkdir -p /app/onlyoffice/MailServer/data && sudo cp -a /home/user/Backup/MailServer/vmail/. $_
sudo mkdir -p /app/onlyoffice/MailServer/data/certs && sudo cp -a /home/user/Backup/MailServer/mailserver/. $_

Step 5: Run the ONLYOFFICE Docs & ONLYOFFICE Community Server images with the same map paths

Run a new ONLYOFFICE Docs container and then the ONLYOFFICE Community Server container connecting them as described here. When running the containers, you will also need to mount data folders exactly as they had been mounted in the previous version.

Now you can run the portal and check the data for consistency and correct work.

To update your ONLYOFFICE Mail integrated with an old ONLYOFFICE Community Server version (lower than 9.1) to the newest version you'll need to make a dump for both the ONLYOFFICE Mail and ONLYOFFICE Community Server MySQL databases and then restore them in the corresponding databases within a new MySQL container. Restoring the ONLYOFFICE Mail backup data should be performed before installing the new version of ONLYOFFICE Mail.

Step 1: Backup data

Enter the ONLYOFFICE Mail container:

sudo docker exec -it onlyoffice-mail-server bash

Create the 'onlyoffice_mailserver' database dump:

mysqldump -u root -pIsadmin123 onlyoffice_mailserver > dump_mailserver.sql

Exit from the container:

exit

Copy the dump file to the host computer:

sudo docker cp onlyoffice-mail-server:/dump_mailserver.sql /home/user/

Step 2: Remove the current ONLYOFFICE Mail container and image

sudo docker rm -f onlyoffice-mail-server
sudo docker rmi -f $(sudo docker images | grep onlyoffice/mailserver | awk '{ print $3 }')

Step 3: Restore data folders

If necessary, restore the /var/log, /var/vmail, /etc/pki/tls/mailserver data folders as it is described in the previous section of this guide (step 4).

You can skip this step if you've mapped data folders during the previous version installation.

Step 4: Install prerequisites

Install prerequisites following these instructions.

Step 5: Install MySQL

Install MySQL following these instructions.

Step 6: Restore the 'onlyoffice_mailserver' database dump.

Copy the dump file into the MySQL container:

sudo docker cp /home/user/dump_mailserver.sql onlyoffice-mysql-server:/dump_mailserver.sql

Enter the MySQL container:

sudo docker exec -it onlyoffice-mysql-server bash

Create the 'onlyoffice_mailserver' database:

mysql -u root -pmy-secret-pw -e "CREATE DATABASE onlyoffice_mailserver"

Restore the dump:

mysql -u root -pmy-secret-pw onlyoffice_mailserver < dump_mailserver.sql

Exit from the container:

exit

Step 7: Install new ONLYOFFICE version

Install new versions of ONLYOFFICE Docs, ONLYOFFICE Mail, ONLYOFFICE Groups following these instructions.