Skip to content



Variables for backup/restore script


With the 2022-10 update it is possible to run the script with multithreading support. This can be used for backups as well as for restores.

To start the backup/restore with multithreading you have to add THREADS as an environment variable in front of the command to execute the script.

THREADS=14 /opt/mailcow-dockerized/helper-scripts/ restore
The number after the = character indicates the number of threads. Please keep your core count -2 to leave enough CPU power for mailcow itself.

Backup path

The script will ask you for a backup location. Inside of this location it will create folders in the format "mailcow_DATE". You should not rename those folders to not break the restore process.

To run a backup unattended, define MAILCOW_BACKUP_LOCATION as environment variable before starting the script:

MAILCOW_BACKUP_LOCATION=/opt/backup /opt/mailcow-dockerized/helper-scripts/ restore


Both variables mentioned above can also be combined! Ex:
MAILCOW_BACKUP_LOCATION=/opt/backup THREADS=14 /opt/mailcow-dockerized/helper-scripts/ restore

Restoring Data


Please do not copy this script to another location.

To run a restore, start mailcow, use the script with "restore" as first parameter.

# Syntax:
# ./helper-scripts/ restore

The script will ask you for a backup location containing the mailcow_DATE folders:

Backup location (absolute path, starting with /): /opt/backup

All available backups in the specified folder (in our example /opt/backup) are then displayed:

Found project name mailcowdockerized
[ 1 ] - /opt/backup/mailcow-2023-12-11-13-27-14/
[ 2 ] - /opt/backup/mailcow-2023-12-11-14-02-06/

Now you can enter the number of your backup that you want to restore, in this example the 2nd backup:

Select a restore point: 2

The script will now display all the backed up components that you can restore, in our case we have selected all for the backup process, so this will now appear here:

[ 0 ] - all
[ 1 ] - Crypt data
[ 2 ] - Rspamd data
[ 3 ] - Mail directory (/var/vmail)
[ 4 ] - Redis DB
[ 5 ] - Postfix data
[ 6 ] - SQL DB

Again, we select the component that we want to restore. Option 0 restores EVERYTHING.

If you want to restore to a different architecture...

If you have made the backup on a different architecture, e.g. x86, and now want to restore this backup to ARM64, the backup of Rspamd is displayed as incompatible and cannot be selected individually. When restoring with the 0 key, the restoration of Rspamd is also skipped.

Example of incompatible Rspamd backup in the selection menu:

[ NaN ] - Rspamd data (incompatible Arch, cannot restore it)

Now mailcow will restore the backups you have selected. Please note that the restoration may take some time, depending on the size of the backups.