From 1ed207c6b109ac1885ba4caa8c36b7d634a29ae8 Mon Sep 17 00:00:00 2001 From: Dan Helfman Date: Mon, 27 Oct 2025 15:58:12 -0700 Subject: [PATCH] =?UTF-8?q?Document=20borgmatic's=20limitations=20around?= =?UTF-8?q?=20parallelism=E2=80=94both=20its=20own=20and=20Borg's=20(#957)?= =?UTF-8?q?.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- NEWS | 3 +++ docs/how-to/make-per-application-backups.md | 14 ++++++++++++++ 2 files changed, 17 insertions(+) diff --git a/NEWS b/NEWS index 993655e1..d930ca96 100644 --- a/NEWS +++ b/NEWS @@ -1,4 +1,7 @@ 2.0.11.dev0 + * #957: Document borgmatic's limitations around parallelism—both its own and Borg's. See the + documentation for more information: + https://torsion.org/borgmatic/how-to/make-per-application-backups/#limitations * #1165: Fix for when the systemd service directories (RuntimeDirectory and StateDirectory) each contain multiple paths. * #1168: Fix for the "list", "info", and "delete" options in "extra_borg_options" being ignored diff --git a/docs/how-to/make-per-application-backups.md b/docs/how-to/make-per-application-backups.md index 1c3d51f5..6eb26c6a 100644 --- a/docs/how-to/make-per-application-backups.md +++ b/docs/how-to/make-per-application-backups.md @@ -59,6 +59,20 @@ entry using borgmatic's `--config` flag instead of relying on `/etc/borgmatic.d`. +## Limitations + +borgmatic does not currently support its own parallelism—being run multiple +times on the same machine simultaneously. In particular, many of the [data +source +hooks](https://torsion.org/borgmatic/reference/configuration/data-sources/) rely +on global borgmatic runtime files which can't be shared across processes, and +therefore multiple borgmatic instances on the same machine would interfere with +each other. + +A single borgmatic instance also doesn't currently support running multiple Borg +instances in parallel on the same machine. + +