borgmatic-collective/borgmatic
borgmatic-collective/borgmatic
9
74
Fork 55
Code Issues 56 Pull requests 4 Releases 160 Packages 1 Activity Actions 1
160 releases 202 tags
  • 2.0.9 2a5e202daf

    borgmatic 2.0.9
    All checks were successful
    build / test (push) Successful in 8m9s
    Details
    build / docs (push) Successful in 1m57s
    Details
    Stable

    witten released this 2025-10-07 16:55:41 +00:00 | 347 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
  • 2.0.8 6d48ff95d2

    borgmatic 2.0.8
    All checks were successful
    build / test (push) Successful in 7m15s
    Details
    build / docs (push) Successful in 1m0s
    Details
    Stable

    witten released this 2025-09-20 00:32:13 +00:00 | 368 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
  • 2.0.7 1a33e5fa1e

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

    witten released this 2025-07-01 01:04:06 +00:00 | 443 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
    Details
    build / docs (push) Successful in 1m17s
    Details
    Stable

    witten released this 2025-05-15 04:16:33 +00:00 | 471 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
    Details
    build / docs (push) Successful in 1m29s
    Details
    Stable

    witten released this 2025-04-29 22:20:50 +00:00 | 490 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
    Details
    build / docs (push) Successful in 1m3s
    Details
    Stable

    witten released this 2025-04-22 21:11:36 +00:00 | 512 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
    Details
    build / docs (push) Successful in 1m19s
    Details
    Stable

    witten released this 2025-04-15 05:53:23 +00:00 | 519 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
    Details
    build / docs (push) Successful in 59s
    Details
    Stable

    witten released this 2025-04-08 19:07:16 +00:00 | 523 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
    Details
    build / docs (push) Has been cancelled
    Details
    Stable

    witten released this 2025-04-06 22:21:03 +00:00 | 538 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
    Details
    build / docs (push) Successful in 1m18s
    Details
    Stable

    witten released this 2025-04-06 15:22:28 +00:00 | 541 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