• 2.0.7 1a33e5fa1e

    borgmatic 2.0.7
    All checks were successful
    build / test (push) Successful in 8m28s
    build / docs (push) Successful in 1m31s
    Stable

    witten released this 2025-07-01 01:04:06 +00:00 | 396 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
  • 2.0.6 b208c5352a

    borgmatic 2.0.6
    All checks were successful
    build / test (push) Successful in 7m5s
    build / docs (push) Successful in 1m17s
    Stable

    witten released this 2025-05-15 04:16:33 +00:00 | 424 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
  • 2.0.5 cdbfe1c1e9

    borgmatic 2.0.5
    All checks were successful
    build / test (push) Successful in 7m17s
    build / docs (push) Successful in 1m29s
    Stable

    witten released this 2025-04-29 22:20:50 +00:00 | 443 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
  • 2.0.4 5465b60d37

    borgmatic 2.0.4
    All checks were successful
    build / test (push) Successful in 6m41s
    build / docs (push) Successful in 1m3s
    Stable

    witten released this 2025-04-22 21:11:36 +00:00 | 465 commits to main since this release

    Downloads
  • 2.0.3 13d49fda9b

    borgmatic 2.0.3
    All checks were successful
    build / test (push) Successful in 6m45s
    build / docs (push) Successful in 1m19s
    Stable

    witten released this 2025-04-15 05:53:23 +00:00 | 472 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
  • 2.0.2 0b4aff9277

    borgmatic 2.0.2
    All checks were successful
    build / test (push) Successful in 6m46s
    build / docs (push) Successful in 59s
    Stable

    witten released this 2025-04-08 19:07:16 +00:00 | 476 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
  • 2.0.1 074db68a1b

    borgmatic 2.0.1
    Some checks failed
    build / test (push) Successful in 6m37s
    build / docs (push) Has been cancelled
    Stable

    witten released this 2025-04-06 22:21:03 +00:00 | 491 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
  • 2.0.0 b25bfbe913

    borgmatic 2.0.0
    All checks were successful
    build / test (push) Successful in 10m51s
    build / docs (push) Successful in 1m18s
    Stable

    witten released this 2025-04-06 15:22:28 +00:00 | 494 commits to main since this release

    • TL;DR: More flexible, completely revamped command hooks. All configuration options settable on
      the command-line. New configuration options for many command-line flags (including verbosity!).
      New "key import" and "recreate" actions. Almost everything is backwards compatible—but mind those
      deprecation warnings!
    • #262: Add a "default_actions" option that supports disabling default actions when borgmatic is
      run without any command-line arguments.
    • #303: Deprecate the "--override" flag in favor of direct command-line flags for every borgmatic
      configuration option. See the documentation for more information:
      https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#configuration-overrides
    • #303: Add configuration options that serve as defaults for some (but not all) command-line
      action flags. For example, each entry in "repositories:" now has an "encryption" option that
      applies to the "repo-create" action, serving as a default for the "--encryption" flag. See the
      documentation for more information: https://torsion.org/borgmatic/docs/reference/configuration/
    • #345: Add a "key import" action to import a repository key from backup.
    • #422: Add home directory expansion to file-based and KeePassXC credential hooks.
    • #610: Add a "recreate" action for recreating archives, for instance for retroactively excluding
      particular files from existing archives.
    • #790, #821: Deprecate all "before_*", "after_*" and "on_error" command hooks in favor of more
      flexible "commands:". See the documentation for more information:
      https://torsion.org/borgmatic/docs/how-to/add-preparation-and-cleanup-steps-to-backups/
    • #790: BREAKING: For both new and deprecated command hooks, run a configured "after" hook even if
      an error occurs first. This allows you to perform cleanup steps that correspond to "before"
      preparation commands—even when something goes wrong.
    • #790: BREAKING: Run all command hooks (both new and deprecated) respecting the
      "working_directory" option if configured, meaning that hook commands are run in that directory.
    • #793: Add configuration options for all verbosity and logging flags, so you don't have to set
      them on the command-line.
    • #836: Add a custom command option for the SQLite hook.
    • #837: Add custom command options for the MongoDB hook.
    • #1010: When using Borg 2, don't pass the "--stats" flag to "borg prune".
    • #1020: Document a database use case involving a temporary database client container:
      https://torsion.org/borgmatic/docs/how-to/backup-your-databases/#containers
    • #1037: Fix an error with the "extract" action when both a remote repository and a
      "working_directory" are used.
    • #1044: Fix an error in the systemd credential hook when the credential name contains a "."
      character.
    • #1047: Add "key-file" and "yubikey" options to the KeePassXC credential hook.
    • #1048: Fix a "no such file or directory" error in ZFS, Btrfs, and LVM hooks with nested
      directories that reside on separate devices/filesystems.
    • #1050: Fix a failure in the "spot" check when the archive contains a symlink.
    • #1051: Add configuration filename to the "Successfully ran configuration file" log message.
    Downloads
  • 1.9.14 fbdb09b87d

    borgmatic 1.9.14
    All checks were successful
    build / test (push) Successful in 6m42s
    build / docs (push) Successful in 1m19s
    Stable

    witten released this 2025-03-10 17:17:36 +00:00 | 682 commits to main since this release

    Downloads
  • 1.9.13 dbe82ff11e

    borgmatic 1.9.13
    All checks were successful
    build / test (push) Successful in 6m46s
    build / docs (push) Successful in 1m14s
    Stable

    witten released this 2025-03-03 18:21:15 +00:00 | 695 commits to main since this release

    • #975: Add a "compression" option to the PostgreSQL database hook.
    • #1001: Fix a ZFS error during snapshot cleanup.
    • #1003: In the Zabbix monitoring hook, support Zabbix 7.2's authentication changes.
    • #1009: Send database passwords to MariaDB and MySQL via anonymous pipe, which is more secure than
      using an environment variable.
    • #1013: Send database passwords to MongoDB via anonymous pipe, which is more secure than using
      "--password" on the command-line!
    • #1015: When ctrl-C is pressed, more strongly encourage Borg to actually exit.
    • Add a "verify_tls" option to the Uptime Kuma monitoring hook for disabling TLS verification.
    • Add "tls" options to the MariaDB and MySQL database hooks to enable or disable TLS encryption
      between client and server.
    Downloads