-
borgmatic 2.0.10
Stablereleased this
2025-10-24 04:47:56 +00:00 | 400 commits to main since this release- #427: Expand the "extra_borg_options" option to support passing arbitrary Borg flags to every
Borg sub-command that borgmatic uses. As part of this, deprecate the "init" option under
"borg_extra_options" in favor of "repo_create". - #942: Factor reference material out of the documentation how-to guides. This means there's now a
whole reference section in the docs! Check it out: https://torsion.org/borgmatic/ - #973: For the MariaDB and MySQL database hooks, add a "skip_names" option to ignore particular
databases when dumping "all". - #1150: Fix for a runtime directory error when the "create" action is used with the "--log-json"
flag. - #1150: Fix for a runtime directory error when the configured patterns contain a global exclude.
- #1161: Fix a traceback (TypeError) in the "check" action with Python 3.14.
- #1166: Add a "borg_key_file" option for setting the Borg repository key file path.
- Add documentation search.
- Change the URL of the local documentation development server to be more like the production URL.
Downloads
-
Source code (ZIP)
4 downloads
-
Source code (TAR.GZ)
6 downloads
- #427: Expand the "extra_borg_options" option to support passing arbitrary Borg flags to every
-
borgmatic 2.0.9
Stablereleased this
2025-10-07 16:55:41 +00:00 | 435 commits to main since this release- #1105: More accurately collect Btrfs subvolumes to snapshot. As part of this, the Btrfs hook no
longer uses "findmnt" and the "findmnt_command" option is deprecated. - #1123: Add loading of systemd credentials even when running borgmatic outside of a systemd
service. - #1149: Add support for Python 3.14.
- #1149: Include automated tests in the source dist tarball uploaded to PyPI.
- #1151: Fix snapshotting in the ZFS, Btrfs, and LVM hooks to play nicely with the Borg 1.4+
"slashdot" hack within source directory paths. - #1152: Fix a regression in the Loki monitoring hook in which log messages weren't sending.
- #1156: Fix snapshotting in the ZFS, Btrfs, and LVM hooks to snapshot both parent and child
volumes/filesystems instead of just the parent. As part of this fix, borgmatic no longer
deduplicates patterns except for those containing the borgmatic runtime directory. - Fix a traceback (TypeError) regression in the "spot" check when the "local_path" option isn't
set.
Downloads
-
Source code (ZIP)
6 downloads
-
Source code (TAR.GZ)
5 downloads
- #1105: More accurately collect Btrfs subvolumes to snapshot. As part of this, the Btrfs hook no
-
borgmatic 2.0.8
Stablereleased this
2025-09-20 00:32:13 +00:00 | 456 commits to main since this release- #1114: Document systemd configuration changes for the ZFS filesystem hook.
- #1116: Add dumping of database containers via their container names, handy for backing up
database containers from the host. See the documentation for more information:
https://torsion.org/borgmatic/docs/how-to/backup-your-databases/#database-client-on-the-host - #1116: Add optional database labels to make it easier to find your dumps within a Borg archive.
- #1118: Fix a bug in which Borg hangs during database backup when different filesystems are in
use. - #1122: To prevent the user from inadvertently excluding the "bootstrap" action's manifest, always
error and exit when the borgmatic runtime directory overlaps with the configured excludes. - #1125: Clarify documentation about ZFS, Btrfs, and LVM snapshotting when a separate
filesystem is mounted in the source directory. (Spoiler: The separate filesystem doesn't get
included in the snapshot.) - #1126: Create LVM snapshots as read-write to avoid an error when snapshotting ext4 filesystems
with orphaned files that need recovery. - #1133: Fix the "spot" check to include borgmatic configuration files that were backed up to
support the "bootstrap" action. - #1136: For all database hooks, record metadata about the dumps contained within an archive.
- #1139: Set "borgmatic" as the user agent when connecting to monitoring services.
- #1146: Fix a broken "create" action and "--archive latest" flag when multiple archives share the
same name with Borg 2. - Treat configuration file permissions issues as errors instead of warnings.
- When running tests, use Ruff for faster and more comprehensive code linting and formatting,
replacing Flake8, Black, isort, etc. - Switch from pipx to uv for installing development tools, and added tox-uv for speeding up test
environment creation. See the developer documentation for more information:
https://torsion.org/borgmatic/docs/how-to/develop-on-borgmatic/
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
1 download
-
borgmatic 2.0.7
Stablereleased this
2025-07-01 01:04:06 +00:00 | 531 commits to main since this release- #1032: Fix a bug in which a Borg archive gets created even when a database hook fails.
- #1043: Support Btrfs subvolume paths in "source_directories" even when the subvolume is mounted
elsewhere. - #1048: Ignore Btrfs subvolumes whose read-only status can't be determined.
- #1083: Add "debug_passphrase"/"display_passphrase" options and a "{unixtime}" placeholder in
support of Borg 2 features. - #1099: Clarify documentation on command hooks order of execution.
- #1100: Fix a bug in which "borg --version" failing isn't considered a "fail" state in a command
hook. - #1108: Fix a bug in which quoted "extra_borg_options" values containing spaces are passed to Borg
incorrectly. - #1108: Add a "--comment" flag to the "create" action for creating an archive with a comment.
- Use the Bandit security analysis tool when running tests.
- SECURITY: Add timeouts to all monitoring hooks to prevent hangs on network requests, e.g. due to
a compromised monitoring server holding requests open. - SECURITY: For the "spot" check, use a more secure source of randomness when selecting paths to
check.
Downloads
-
Source code (ZIP)
6 downloads
-
Source code (TAR.GZ)
6 downloads
-
borgmatic 2.0.6
Stablereleased this
2025-05-15 04:16:33 +00:00 | 559 commits to main since this release- #1068: Fix a warning from LVM about leaked file descriptors.
- #1086: Fix for the "spot" check breaking when the "--progress" flag is used.
- #1089: Fix for the "spot" check erroring when a checksum command errors.
- #1091: Fix for the "config generate" action generating invalid configuration when upgrading
deprecated command hooks. - #1093: Fix for the LVM hook erroring when the "--dry-run" flag is used.
- #1094: Fix incorrect documentation about customizing Borg exit codes:
https://torsion.org/borgmatic/docs/how-to/customize-warnings-and-errors/ - #1095: Fix for the "spot" check's "xxh64sum_command" option erroring on commands containing
spaces. - Add support for Borg 2's "s3:" and "b2:" repository URLs, so you can backup to S3 or B2 cloud
storage services even without using Rclone. - During the "spot" check, truncate log messages containing many file paths.
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
1 download
-
borgmatic 2.0.5
Stablereleased this
2025-04-29 22:20:50 +00:00 | 578 commits to main since this release- #1033: Add a "password_transport" option to the MariaDB and MySQL database hooks for customizing
how borgmatic transmits passwords to the database client. - #1078: Add "keep_3monthly" and "keep_13weekly" options for customizing "prune" action archive
retention. - #1078: Add a "use_chunks_archive" option for controlling whether Borg uses its chunks cache
directory. - #1078: For the "compact" action, pass "--dry-run" through to Borg.
- #1085: Fix a regression in which the default monitoring verbosity is 0 (warnings only) instead of
1 (info about steps borgmatic is taking). This prevented logs from showing up in monitoring
services like Healthchecks unless you had an explicit monitoring verbosity set. - Move Mastodon social hosting from Fosstodon to FLOSS.social: https://floss.social/@borgmatic
- The borgmatic project no longer accepts pull requests on GitHub. But see
https://torsion.org/borgmatic/#contributing for how you can still submit pull requests. You can
even use your GitHub account to login.
Downloads
-
Source code (ZIP)
5 downloads
-
Source code (TAR.GZ)
1 download
- #1033: Add a "password_transport" option to the MariaDB and MySQL database hooks for customizing
-
borgmatic 2.0.4
Stablereleased this
2025-04-22 21:11:36 +00:00 | 600 commits to main since this release- #1072: Fix path rewriting for non-root patterns in the ZFS, Btrfs, and LVM hooks.
- #1073: Clarify the documentation about when an "after: error" command hook runs and how it
differs from other hooks:
https://torsion.org/borgmatic/docs/how-to/add-preparation-and-cleanup-steps-to-backups/ - #1075: Fix an incorrect warning about Borg placeholders being unsupported in a command hook.
- #1080: If the exact same "everything" command hook is present in multiple configuration files,
only run it once.
Downloads
-
Source code (ZIP)
7 downloads
-
Source code (TAR.GZ)
1 download
-
borgmatic 2.0.3
Stablereleased this
2025-04-15 05:53:23 +00:00 | 607 commits to main since this release- #1065: Fix a regression in monitoring hooks in which an error pinged the finish state instead of
the fail state. - #1066: Add a "states" option to command hooks, so you can optionally skip an "after" hook if
borgmatic encounters an error. - #1071: Fix an error in the LVM hook when removing a snapshot directory.
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
0 downloads
- #1065: Fix a regression in monitoring hooks in which an error pinged the finish state instead of
-
borgmatic 2.0.2
Stablereleased this
2025-04-08 19:07:16 +00:00 | 611 commits to main since this release- #1035: Document potential performance issues and workarounds with the ZFS, Btrfs, and LVM hooks:
https://torsion.org/borgmatic/docs/how-to/snapshot-your-filesystems/ - #1053: Display a nicer error message when the "recreate" action encounters an archive that
already exists. - #1059: Fix a regression in which soft failure exit codes in command hooks were not respected.
- #1060: Fix action command hooks getting run too many times when multiple borgmatic actions are
executed (implicitly or explicitly). - #1060: Don't run action command hooks for actions listed in the "skip_actions" option.
- #1062: Fix a regression that broke environment variable interpolation.
- #1063: List the configured "when" action names in the log entries for command hooks.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
1 download
- #1035: Document potential performance issues and workarounds with the ZFS, Btrfs, and LVM hooks:
-
borgmatic 2.0.1
Stablereleased this
2025-04-06 22:21:03 +00:00 | 626 commits to main since this release- #1057: Fix argument parsing to avoid using Python 3.12+ string features. Now borgmatic will
work with Python 3.9, 3.10, and 3.11 again.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- #1057: Fix argument parsing to avoid using Python 3.12+ string features. Now borgmatic will