asif/MailcowBackup
1
0
Fork 0
Code Issues Releases 10 Wiki Activity
Page: 8.0 Restore overview
Pages
0. Overview 1.0 Quick start 2.0 Installation 2.1 Configuration notes 2.2 Run as root 3.0 Script parameters 4.0 Configuration details file 4.1 Extra backup locations 4.2 Excluded backup locations 4.3 Prune timeframe examples 4.4 Configuration examples 5.0 503 functionality 6.0 Scheduling via cron 7.0 Logs 7.1 Using logwatch 7.1.1 Logfile Group file 7.1.2 Service definition file 7.1.3 Service script 7.1.4 Timestamp processing 7.1.5 Testing 8.0 Restore overview 8.1 Restore extract 8.2 Restore install mailcow 8.3 Restore restoring data 8.3.1 Restore manual restore 9.0 Final notes
1 8.0 Restore overview
Asif Bacchus edited this page 2021-02-10 07:48:19 -07:00
Unescape Escape
Table of Contents
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Restoring Backups

Restoring mailcow backups made by the backup script in this git repo is very much like doing a migration between servers. The notable exception is that the SQL database is restored from a dump file instead of straight-copied. The majority of these instructions will discuss a semi-automated restore using the new restore.sh script. If you want to do a fully manual restore, please refer to page 8.3.1.

Overview

First off, please remember to run everything as root! This will allow borg to restore files with proper permissions, ensure that docker doesn’t run into any problems and generally make your life easier.

The basic restore process is as follows:

  1. Download (‘extract’) the borg backup archive you want to restore from your remote repository to a local directory.

  2. Basic first-install of mailcow:

    1. Download mailcow git repo
    2. Run `generate.sh` to create configuration, CA list and snake-oil certificates

  3. Copy configuration files from restored backup to mailcow directory (i.e. /opt/mailcow-dockerized):

    • mailcow.conf
    • customization files (usually in data/conf/…)
    • certificates
    • etc.

  4. Start mailcow normally once to generate default configurations and volumes.

  5. Browse to mailcow admin panel and/or SOGo (front page) to verify everything is working with the defaults and the install is working before data restore.

  6. Run restore.sh script to restore data.

If this overview is enough for you to figure things out, then you can get started. Remember, you can run the restore script with the --help parameter for a quick overview on how to use it:

./restore.sh --help

If you need a little more guidance, the following pages will go through each step.