-
borgmatic 2.2.0 Stable
released this
2026-10-29 18:33:27 +00:00 | 28 commits to main since this release- #1273: Add a tarballs hook for backing up and restoring tar files while retaining full Borg
deduplication of their contents, handy for large tarballs like VM backups. See the documentation
for more information:
https://torsion.org/borgmatic/reference/configuration/data-sources/tarballs/ - #1360: With the "borg" action, support the "--dry-run" flag when specified after "borg" on the
command-line. - #1368: Fix a hang in which a database dump command spewing lots of output could send borgmatic
into a loop. This was most prevalent with MongoDB. - #1370: Fix "Too many open files" and "filedescriptor out of range in select()" errors when
dumping hundreds of databases. - #1371: Fix an attribute error when running the experimental "browse" action with older versions
of the Textual library. - #1372: In the browse action, show a size for every file and directory, with directory sizes
summed from the sizes of the files beneath them. - #1376: Fix a regression in which ZFS/LVM/Btrfs hooks no longer got Borg cache hits due to a
random temporary directory created within the borgmatic runtime directory. - SECURITY: Upgrade the certifi dependency to remove trusted eMudhra certificates, thereby
addressing the eMudhra certificate authority compromise. This affects outgoing HTTP requests made
from borgmatic monitoring hooks, and only applies to the precompiled borgmatic binary (which
bundles certifi). - Fix a Postgresql hook error when restoring a directory format database with an overridden
hostname or port. - Fix a bug in which borgmatic didn't correctly rename checkpoint archives when database hooks were
enabled with Borg 2. - Fix a theoretical hang in which borgmatic neglected to consume sub-process stderr output. Applies
to "restore", "browse", and "config bootstrap" actions. - Fix a bug in which a literal flag value of "borg" could throw off command-line parsing for the
"borg" action. - Add a "--json" flag to the "diff" action for outputting one JSON object per changed path.
- Add a pull request template to guide the creation of any new pull request.
- Drop support for Python 3.10, which has been end-of-lifed.
- Fix package metadata to reflect that Python 3.9 support was dropped back in borgmatic 2.0.11.
Downloads
-
Source code (ZIP)
2 downloads
-
Source code (TAR.GZ)
10 downloads
- #1273: Add a tarballs hook for backing up and restoring tar files while retaining full Borg
-
borgmatic 2.1.10
Stablereleased this
2026-10-05 16:16:00 +00:00 | 106 commits to main since this release- #1185: Add support for setting top-level configuration options under each repository, making
those options repository-specific. See the documentation for more information:
https://torsion.org/borgmatic/reference/configuration/repositories/ - #1361: Update command-line overrides to support disabling configuration options, e.g.
"--no-btrfs" to temporarily disable the Btrfs hook. - #1361: Fix a traceback (TypeError) in command-line overrides when setting a sub-option of an
option without a configured value. - #1362, #1364: For the ZFS, LVM, and Btrfs hooks, support relative source paths with a configured
working directory. - #1363: For the "restore" action, fix an invalid JSON error when running with the "--dry-run"
flag. - Remove support for "rest://" repository URLs, which Borg 2.0.0b25 renamed back to "ssh://".
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
41 downloads
- #1185: Add support for setting top-level configuration options under each repository, making
-
borgmatic 2.1.9
Stablereleased this
2026-09-25 22:53:31 +00:00 | 126 commits to main since this release- #951: For the PostgreSQL, MariaDB, and MySQL database hooks, support globs in configured database
names (e.g. "users_*"), so borgmatic can dump multiple matching databases without needing each
one defined in configuration. - #951: Add glob support to the "--data-source" flag on the "restore" action.
- #1316: Deprecate "statistics" and "quick_statistics" true/false options, replacing them with a
single combined "statistics" option that expects a named value. - #1316: Enforce that "--stats" and "--quick-stats" flags aren't used together.
- #1354, #1353: Fix a regression in which soft failure exit codes in command hooks were not
respected. - #1355: Fix a regression in which the MongoDB hook no longer worked with passwordless database
connections.
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
14 downloads
- #951: For the PostgreSQL, MariaDB, and MySQL database hooks, support globs in configured database
-
borgmatic 2.1.8 Stable
released this
2026-09-18 17:21:11 +00:00 | 132 commits to main since this release- #450: Add an InfluxDB database hook for dumping and restoring InfluxDB 1 and 2 databases. See the
documentation for more information:
https://torsion.org/borgmatic/reference/configuration/data-sources/influxdb/ - #1332: For the MongoDB hook, add a "password_transport" option for customizing how borgmatic
transmits passwords to the database client. See the documentation for more information:
https://torsion.org/borgmatic/reference/configuration/data-sources/mongodb/ - #1345: Add a 1Password credential hook for loading credentials from the 1Password CLI. See the
documentation for more information:
https://torsion.org/borgmatic/reference/configuration/credentials/onepassword/ - #1346: Add an OpenLDAP database hook for dumping and restoring OpenLDAP databases with slapcat
and slapadd. See the documentation for more information:
https://torsion.org/borgmatic/reference/configuration/data-sources/openldap/ - #1348: Add support for "rest://" repository URLs introduced in Borg 2.0.0b22.
- #1348: BREAKING: For the "prune" action, remove Borg 2's "--oldest", "--newest", "--older", and
"--newer" flags, as Borg 2.0.0b22 has removed them. - #1348: For the "prune" action, add support for Borg 2's "--from" flag.
- #1349: Fix for Borg 2.0.0b23 dropping support for the "--remote-path" flag in favor of an
environment variable. - #1349: Document the "upload_rate_limit" and "upload_buffer_size" option as Borg 1.x only.
- #1340: For the
--repairflag on thecheckaction, don't attempt to runborg infofirst,
as it can fail on a corrupted repository—like the kind you might by trying to repair. Also ignore
any check frequency/days configuration and skip recording check timestamps. - #1352: Fix a hang in which PostgreSQL child processes prevented borgmatic from exiting when Borg
errored out. - #1353: Fix for soft failures in command hooks incorrectly being treated as hard failures,
resulting in monitoring ping fails. - For the "user_runtime_directory" option and the "XDG_RUNTIME_DIR" environment variable, create a
temporary directory for borgmatic within the given runtime directory. This makes cleanup easier
and prevents unintentional runtime file reuse across borgmatic runs.
Downloads
-
Source code (ZIP)
3 downloads
-
Source code (TAR.GZ)
13 downloads
- #450: Add an InfluxDB database hook for dumping and restoring InfluxDB 1 and 2 databases. See the
-
borgmatic 2.1.7
Stablereleased this
2026-08-14 19:20:14 +00:00 | 223 commits to main since this release- #1309: Add support for the "--quick-stats" flag and the "quick_statistics" option to the "prune"
action. Borg >= 1.4.5 and < 2 only. - #1310: For the "bootstrap" action, provide a more helpful error message when borgmatic can't
determine the latest archive. - #1317: Add an "archive_hostname" option and a corresponding "--archive-hostname" flag for
overriding the hostname used for the "{hostname}" placeholder in the "archive_name_format"
option. Also add an "archive_username" option and corresponding "--archive-username" flag to
override the "{user}" placeholder. Both options/flags are Borg 1.4.5+ only. - #1319: Fix the ZFS hook's overzealous unmounting of snapshot paths when a source dataset is at
"/". - #1322: Fix for the "restore" action sometimes failing to find a database dump that was dumped
with a default port. - #1324: For the MariaDB and MySQL hooks, add "events", "routines", and "tablespaces" options for
disabling dumping of scheduled events, stored routines, and tablespaces, respectively. - #1327: Fix an error from the "diff" action when exclude options are configured.
- #1331: Fix the "repo-create" action to more surgically suppress Borg "Repository does not exist"
logs and avoid inadvertently suppressing other error logs. - #1333: Fix the "--progress" flag on the "compact" action to actually update the progress of
segment compaction. - #1334: Add the "CAP_FOWNER" capability to "CapabilityBoundingSet" in the sample systemd service,
so that Borg can open source files without changing file access times. - #1336: Fix for the "bootstrap" action ignoring the "--verbosity" flag when no configuration is
present. - #1335: Add a Watchgoose monitoring hook. See the documentation for more information:
https://torsion.org/borgmatic/reference/configuration/monitoring/watchgoose/ - BREAKING: Remove the Cronhub monitoring hook, as Cronhub has shut down.
- Fix a bug in which the "compact" action does not pass a compact threshold of zero to Borg.
- Add support for the Borg 2 "--id-hash", "--key-location", and "--from-borg1" flags on the
"repo-create" action. Also add corresponding configuration "id_hash" and "key_location" options
under the "repositories" option. - Add support for the Borg 2 "--from-borg1" flag on the "transfer" action.
- Update the documentation on upgrading repositories from Borg version 1 to 2, using current Borg
2 flags: https://torsion.org/borgmatic/how-to/upgrade/#borg-1-to-2
Downloads
-
Source code (ZIP)
3 downloads
-
Source code (TAR.GZ)
50 downloads
- #1309: Add support for the "--quick-stats" flag and the "quick_statistics" option to the "prune"
-
borgmatic 2.1.6
Stablereleased this
2026-06-01 22:52:45 +00:00 | 251 commits to main since this release- #1256: Fix a race condition in which borgmatic sometimes swallows Borg error output without
logging it. - #1300: Fix the "source_directories_must_exist" option to support source directories relative to a
"working_directory". - #1301: Expand the "patterns_from" and "exclude_from" options to support paths containing tildes
and globs. - #1303: For the MariaDB and MySQL database hooks, include events, routines, and tablespaces when
dumping a database. - #1303: For the MariaDB hook, include only a subset of system data when dumping the "mysql" system
database (or "all" databases), so the dump is actually restorable. See the documentation for more
information: https://torsion.org/borgmatic/reference/configuration/data-sources/mariadb/ - #1308: Update the Apprise monitoring hook's "url" option to support loading credentials with the
"{credential ...}" syntax. See the documentation for more information:
https://torsion.org/borgmatic/reference/configuration/credentials/ - #1309: Add a "--quick-stats" flag and corresponding "quick_statistics" option for showing only
abbreviated statistics for the "create" action. Borg 1.4.5+ only. - #1314: Add a minimal stand-alone borgmatic binary in addition to the standard one. The minimal
binary omits support for the Apprise monitoring hook. - Add an experimental "browse" action providing a console UI for browsing your backups. See the
documentation for more information:
https://torsion.org/borgmatic/how-to/inspect-your-backups/#browsing-backups - Update the KeePassXC credential hook to support KeePassXC's secret service integration. See the
documentation for more information:
https://torsion.org/borgmatic/reference/configuration/credentials/keepassxc/ - Add the NEWS changelog file to release tarball (#1298).
- Enable reply by email on projects.torsion.org, so replies to notification emails get posted as
comments on tickets. - For the MariaDB and MySQL database hooks, escape quotes in passwords when the
"password_transport" option is "pipe". - Add a development script for upgrading pinned dependencies.
- Fix the PostgreSQL database hook to properly parse "*options" values containing quoted spaces.
- Update the documentation to use Pagefind's component-based search UI.
Downloads
-
Source code (ZIP)
5 downloads
-
Source code (TAR.GZ)
36 downloads
- #1256: Fix a race condition in which borgmatic sometimes swallows Borg error output without
-
borgmatic 2.1.5
Stablereleased this
2026-04-20 16:46:54 +00:00 | 345 commits to main since this release- #1229: Document the permissions needed for the PostgreSQL database hook:
https://torsion.org/borgmatic/reference/configuration/data-sources/postgresql/ - #1289: Add mutual TLS support for the Loki monitoring hook. See the documentation for more
information: https://torsion.org/borgmatic/reference/configuration/monitoring/loki/ - #1292: Fix a "source directories do not exist" regression when configuration paths are relative
symlinks and the bootstrap data source hook is enabled. - #1294: Fix a regression in which SSH warnings from remote repositories broke the "spot" check
and other actions as well. - #1295: Fix the ZFS hook to properly unmount snapshots for empty datasets.
Downloads
-
Source code (ZIP)
4 downloads
-
Source code (TAR.GZ)
32 downloads
- #1229: Document the permissions needed for the PostgreSQL database hook:
-
borgmatic 2.1.4
Stablereleased this
2026-04-06 02:57:22 +00:00 | 357 commits to main since this release- #1266: Add a stand-alone borgmatic Linux binary to the release downloads to serve as another way
to install borgmatic. Consider this binary a beta feature. - #1286: Fix a regression in which running borgmatic with no arguments and no configuration files
doesn't error as expected. - #1257: Fix for the Loki monitoring hook not respecting the monitoring verbosity.
- #1264: Improve performance of the "info" and "repo-list" actions by eliminating a second "borg
info" call that supports a "no matching archives" warning. The warning still occurs; it's just
done now without the extra "borg info" call. - #1268: Fix the "spot" check, "extract" check, and all uses of the archive name "latest" to
respect the "match_archives" and "archives_name_format" options. This means that borgmatic now
uses the "latest" archive that also matches those options instead of the latest archive overall. - When Borg exits with a warning exit code, show a description of it, so you don't have to look up
the code. - Split out borgmatic installation documentation to its own page, so it's easier to find.
- Switch the default borgmatic installation method from pipx to uv, as uv is faster and used for
borgmatic development. If you'd like to switch, see the documentation for more information:
https://torsion.org/borgmatic/how-to/upgrade/ - Move the project tracker from Gitea to Forgejo.
- Fix a regression in which borgmatic didn't show an error message when run with no configuration.
- Fix a traceback in the "spot" check with Borg 2.
Downloads
-
Source code (ZIP)
12 downloads
-
Source code (TAR.GZ)
83 downloads
- #1266: Add a stand-alone borgmatic Linux binary to the release downloads to serve as another way
-
borgmatic 2.1.3
Stablereleased this
2026-03-06 18:19:42 +00:00 | 383 commits to main since this release- #1175: Add a "files_changed" option for customizing Borg's file modification detection.
- #1175: Add a "msgpack_version_check" option to prevent Borg from validating msgpack's version.
- #1218: Add a "config show" action to display computed borgmatic configuration as YAML or JSON,
handy for fetching borgmatic configuration from external scripts. See the documentation for more
information:
https://torsion.org/borgmatic/reference/command-line/actions/config-show/ - #1228: Adjust the "spot" check so error output includes more information about what failed.
- #1236: Fix the "spot" check to skip hard links, as Borg doesn't produces hashes for them.
- #1243: Add a "diff" action for viewing the difference between the contents of two archives.
- #1248: Go back to treating Borg "file not found" warnings (exit code 107) as
warnings instead of errors. Otherwise, borgmatic can error on files that a user intentionally
deletes while a backup is running. You can still override this behavior with the
"borg_exit_codes" option. See the documentation for more information:
https://torsion.org/borgmatic/how-to/customize-warnings-and-errors/ - #1248: Un-deprecate the "source_directories_must_exist" option and default it to true, to
compensate for Borg "file not found" warnings no longer being treated as errors. - #1269: Fix the ZFS hook to support datasets with a "canmount" property of "noauto".
- #1270: Follow symlinks when backing up borgmatic configuration files to support the "bootstrap"
action. - #1274: Add an optional override for the documentation development listen port and use Podman
Compose if present. - #1281: Fix a unicode error when backing up a non-UTF-8 source filename with a
corresponding system locale. - Add a policy about the use of generative AI in the borgmatic codebase:
https://torsion.org/borgmatic/how-to/develop-on-borgmatic/#use-of-generative-ai
Downloads
-
Source code (ZIP)
14 downloads
-
Source code (TAR.GZ)
20 downloads
-
borgmatic 2.1.2
Stablereleased this
2026-02-06 20:53:27 +00:00 | 432 commits to main since this release- #1231: If a source file is deleted during a "spot" check, consider the file as non-matching
and move on instead of immediately failing the entire check. - #1250: Fix a regression in which the "--stats" flag hides statistics at default verbosity.
- #1251: Fix a regression in the ntfy monitoring hook in which borgmatic sends tags incorrectly,
resulting in "400 Bad Request" from ntfy. - #1258: Fix a "codec can't decode byte" error when running commands that output multi-byte unicode
characters. - #1260: Fix for SSH warnings from Borg showing up as JSON logs even without the "--log-json" flag.
- #1252: Work around Borg returning a warning exit code when a repository/archive check fails. Now,
borgmatic interprets such failures as errors. - Deduplicate overlapping source directories and patterns so they don't throw off "spot" check file
counts and cause spurious check failures.
Downloads
-
Source code (ZIP)
14 downloads
-
Source code (TAR.GZ)
17 downloads
- #1231: If a source file is deleted during a "spot" check, consider the file as non-matching