Skip to content

Commit

Permalink
Add info about needed changes in older config.yaml (#629)
Browse files Browse the repository at this point in the history
borgmatic configuration files before v1.8.0
  • Loading branch information
accolon authored Sep 23, 2023
1 parent 3ca4e3c commit 39432c5
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 0 deletions.
7 changes: 7 additions & 0 deletions docs/third_party/borgmatic/third_party-borgmatic.de.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
7 changes: 7 additions & 0 deletions docs/third_party/borgmatic/third_party-borgmatic.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

0 comments on commit 39432c5

Please sign in to comment.