• 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 | 629 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 | 817 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 | 830 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
  • 1.9.12 596305e3de

    borgmatic 1.9.12
    All checks were successful
    build / test (push) Successful in 6m34s
    build / docs (push) Successful in 1m11s
    Stable

    witten released this 2025-02-23 17:59:53 +00:00 | 859 commits to main since this release

    • #1005: Fix the credential hooks to avoid using Python 3.12+ string features. Now borgmatic will
      work with Python 3.9, 3.10, and 3.11 again.
    Downloads
  • 1.9.11 4f88018558

    borgmatic 1.9.11
    All checks were successful
    build / test (push) Successful in 6m17s
    build / docs (push) Successful in 1m21s
    Stable

    witten released this 2025-02-22 22:39:45 +00:00 | 862 commits to main since this release

    • #795: Add credential loading from file, KeePassXC, and Docker/Podman secrets. See the
      documentation for more information:
      https://torsion.org/borgmatic/docs/how-to/provide-your-passwords/
    • #996: Fix the "create" action to omit the repository label prefix from Borg's output when
      databases are enabled.
    • #998: Send the "encryption_passphrase" option to Borg via an anonymous pipe, which is more secure
      than using an environment variable.
    • #999: Fix a runtime directory error from a conflict between "extra_borg_options" and special file
      detection.
    • #1001: For the ZFS, Btrfs, and LVM hooks, only make snapshots for root patterns that come from
      a borgmatic configuration option (e.g. "source_directories")—not from other hooks within
      borgmatic.
    • #1001: Fix a ZFS/LVM error due to colliding snapshot mount points for nested datasets or logical
      volumes.
    • #1001: Don't try to snapshot ZFS datasets that have the "canmount=off" property.
    • Fix another error in the Btrfs hook when a subvolume mounted at "/" is configured in borgmatic's
      source directories.
    Downloads
  • 1.9.10 50096296da

    borgmatic 1.9.10
    All checks were successful
    build / test (push) Successful in 8m19s
    build / docs (push) Successful in 1m39s
    Stable

    witten released this 2025-02-11 06:01:23 +00:00 | 900 commits to main since this release

    • #966: Add a "{credential ...}" syntax for loading systemd credentials into borgmatic
      configuration files. See the documentation for more information:
      https://torsion.org/borgmatic/docs/how-to/provide-your-passwords/
    • #987: Fix a "list" action error when the "encryption_passcommand" option is set.
    • #987: When both "encryption_passcommand" and "encryption_passphrase" are configured, prefer
      "encryption_passphrase" even if it's an empty value.
    • #988: With the "max_duration" option or the "--max-duration" flag, run the archives and
      repository checks separately so they don't interfere with one another. Previously, borgmatic
      refused to run checks in this situation.
    • #989: Fix the log message code to avoid using Python 3.10+ logging features. Now borgmatic will
      work with Python 3.9 again.
    • Capture and delay any log records produced before logging is fully configured, so early log
      records don't get lost.
    • Add support for Python 3.13.
    Downloads
  • 1.9.9 d29d0bc1c6

    borgmatic 1.9.9
    All checks were successful
    build / test (push) Successful in 6m37s
    build / docs (push) Successful in 1m30s
    Stable

    witten released this 2025-02-03 19:22:54 +00:00 | 921 commits to main since this release

    • #635: Log the repository path or label on every relevant log message, not just some logs.
    • #961: When the "encryption_passcommand" option is set, call the command once from borgmatic to
      collect the encryption passphrase and then pass it to Borg multiple times. See the documentation
      for more information: https://torsion.org/borgmatic/docs/how-to/provide-your-passwords/
    • #981: Fix a "spot" check file count delta error.
    • #982: Fix for borgmatic "exclude_patterns" and "exclude_from" recursing into excluded
      subdirectories.
    • #983: Fix the Btrfs hook to support subvolumes with names like "@home" different from their
      mount points.
    • #985: Change the default value for the "--original-hostname" flag from "localhost" to no host
      specified. This way, the "restore" action works without a hostname if there's a single matching
      database dump.
    Downloads
  • 1.9.8 730350b31a

    borgmatic 1.9.8
    All checks were successful
    build / test (push) Successful in 3m56s
    build / docs (push) Successful in 1m6s
    Stable

    witten released this 2025-01-25 16:04:13 +00:00 | 957 commits to main since this release

    • #979: Fix root patterns so they don't have an invalid "sh:" prefix before getting passed to Borg.
    • Expand the recent contributors documentation section to include ticket submitters—not just code
      contributors—because there are multiple ways to contribute to the project! See:
      https://torsion.org/borgmatic/#recent-contributors
    Downloads
  • 1.9.7 f08014e3be

    borgmatic 1.9.7
    All checks were successful
    build / test (push) Successful in 4m23s
    build / docs (push) Successful in 1m36s
    Stable

    witten released this 2025-01-23 20:11:27 +00:00 | 963 commits to main since this release

    • #855: Add a Sentry monitoring hook. See the documentation for more information:
      https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#sentry-hook
    • #968: Fix for a "spot" check error when a filename in the most recent archive contains a newline.
    • #970: Fix for an error when there's a blank line in the configured patterns or excludes.
    • #971: Fix for "exclude_from" files being completely ignored.
    • #977: Fix for "exclude_patterns" and "exclude_from" not supporting explicit pattern styles (e.g.,
      "sh:" or "re:").
    Downloads
  • 1.9.6 e789de0851

    borgmatic 1.9.6
    All checks were successful
    build / test (push) Successful in 3m52s
    build / docs (push) Successful in 54s
    Stable

    witten released this 2025-01-17 21:50:22 +00:00 | 976 commits to main since this release

    • #959: Fix an error in the Btrfs hook when a subvolume mounted at "/" is configured in borgmatic's
      source directories.
    • #960: Fix for archives storing relative source directory paths such that they contain the working
      directory.
    • #960: Fix the "spot" check to support relative source directory paths.
    • #962: For the ZFS, Btrfs, and LVM hooks, perform path rewriting for excludes and patterns in
      addition to the existing source directories rewriting.
    • #962: Under the hood, merge all configured source directories, excludes, and patterns into a
      unified temporary patterns file for passing to Borg. The borgmatic configuration options remain
      unchanged.
    • #962: For the LVM hook, add support for nested logical volumes.
    • #965: Fix a borgmatic runtime directory error when running the "spot" check with a database hook
      enabled.
    • #969: Fix the "restore" action to work on database dumps without a port when a default port is
      present in configuration.
    • Fix the "spot" check to no longer consider pipe files within an archive for file comparisons.
    • Fix the "spot" check to have a nicer error when there are no source paths to compare.
    • Fix auto-excluding of special files (when databases are configured) to support relative source
      directory paths.
    • Drop support for Python 3.8, which has been end-of-lifed.
    Downloads