From 39432c5cfd3bba59ee62df033f54b9e2132a73d5 Mon Sep 17 00:00:00 2001 From: accolon Date: Sat, 23 Sep 2023 12:34:45 +0200 Subject: [PATCH] Add info about needed changes in older config.yaml (#629) borgmatic configuration files before v1.8.0 --- docs/third_party/borgmatic/third_party-borgmatic.de.md | 7 +++++++ docs/third_party/borgmatic/third_party-borgmatic.en.md | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/docs/third_party/borgmatic/third_party-borgmatic.de.md b/docs/third_party/borgmatic/third_party-borgmatic.de.md index 4f6044b5d..bdf2d641c 100644 --- a/docs/third_party/borgmatic/third_party-borgmatic.de.md +++ b/docs/third_party/borgmatic/third_party-borgmatic.de.md @@ -90,6 +90,13 @@ EOF Das Erstellen der Datei auf diese Weise stellt sicher, dass die korrekten MySQL-Zugangsdaten aus `mailcow.conf` übernommen werden. +!!! warning + Ab borgmatic 1.8.0 (erschienen am 19. Juli 2023) wurde der Aufbau der Konfigurationsdatei + [geändert](https://github.com/borgmatic-collective/borgmatic/releases/tag/1.8.0). Sie können die Docker-Logs + des Borgmatic-Containers auf Deprecation-Warnmeldungen prüfen, um festzustellen, ob Sie betroffen sind und Ihre + Konfigurationsdatei für eine ältere Version von borgmatic erstellt wurde. In diesem Fall sollten Sie eine neue + `config.yaml`-Datei wie oben beschrieben erstellen, um Probleme mit zukünftigen Versionen von borgmatic zu vermeiden. + Diese Datei ist ein minimales Beispiel für die Verwendung von borgmatic mit einem Konto `user` beim Cloud-Speicheranbieter `rsync.net` für ein Repository namens `mailcow` (siehe `repositories` Einstellung). Es wird sowohl das maildir als auch die MySQL-Datenbank sichern, was alles ist was alles ist, was Sie brauchen, um Ihr mailcow Setup nach einem Vorfall wiederherzustellen. Die Aufbewahrungseinstellungen werden ein Archiv für diff --git a/docs/third_party/borgmatic/third_party-borgmatic.en.md b/docs/third_party/borgmatic/third_party-borgmatic.en.md index 3c9d7f60e..f8e9aad30 100644 --- a/docs/third_party/borgmatic/third_party-borgmatic.en.md +++ b/docs/third_party/borgmatic/third_party-borgmatic.en.md @@ -91,6 +91,13 @@ EOF Creating the file in this way ensures the correct MySQL credentials are pulled in from `mailcow.conf`. +!!! warning + Starting with borgmatic 1.8.0 (released July 19th, 2023), the configuration file syntax was + [changed](https://github.com/borgmatic-collective/borgmatic/releases/tag/1.8.0). You can check the Docker logs + of the borgmatic container for deprecation warnings to see if you are affected, i.e. if your config file was + generated for an older borgmatic version. In this case, you should create a new `config.yaml` file as described + above to avoid problems with future borgmatic releases. + This file is a minimal example for using borgmatic with an account `user` on the cloud storage provider `rsync.net` for a repository called `mailcow` (see `repositories` setting). It will backup both the maildir and MySQL database, which is all you should need to restore your mailcow setup after an incident. The retention settings will keep one archive for