Releases: borgmatic-collective/borgmatic
Releases · borgmatic-collective/borgmatic
borgmatic 1.8.12
- #817: Add a "--max-duration" flag to the "check" action and a "max_duration" option to the
repository check configuration. This tells Borg to interrupt a repository check after a certain
duration. - #860: Fix interaction between environment variable interpolation in constants and shell escaping.
- #863: When color output is disabled (explicitly or implicitly), don't prefix each log line with
the log level. - #865: Add an "upload_buffer_size" option to set the size of the upload buffer used in "create"
action. - #866: Fix "Argument list too long" error in the "spot" check when checking hundreds of thousands
of files at once. - #874: Add the configured repository label as "repository_label" to the interpolated variables
passed to before/after command hooks. - #881: Fix "Unrecognized argument" error when the same value is used with different command-line
flags. - In the "spot" check, don't try to hash symlinked directories.
borgmatic 1.8.11
- #815: Add optional Healthchecks auto-provisioning via "create_slug" option.
- #851: Fix lack of file extraction when using "extract --strip-components all" on a path with a
leading slash. - #854: Fix a traceback when the "data" consistency check is used.
- #857: Fix a traceback with "check --only spot" when the "spot" check is unconfigured.
borgmatic 1.8.10
- #656 (beta): Add a "spot" consistency check that compares file counts and contents between your
source files and the latest archive, ensuring they fall within configured tolerances. This can
catch problems like incorrect excludes, inadvertent deletes, files changed by malware, etc. See
the documentation for more information:
https://torsion.org/borgmatic/docs/how-to/deal-with-very-large-backups/#spot-check - #779: When "--match-archives *" is used with "check" action, don't skip Borg's orphaned objects
check. - #842: When a command hook exits with a soft failure, ping the log and finish states for any
configured monitoring hooks. - #843: Add documentation link to Loki dashboard for borgmatic:
https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#loki-hook - #847: Fix "--json" error when Borg includes non-JSON warnings in JSON output.
- #848: SECURITY: Mask the password when logging a MongoDB dump or restore command.
- Fix handling of the NO_COLOR environment variable to ignore an empty value.
- Add documentation about backing up containerized databases by configuring borgmatic to exec into
a container to run a dump command:
https://torsion.org/borgmatic/docs/how-to/backup-your-databases/#containers
borgmatic 1.8.9
- #311: Add custom dump/restore command options for MySQL and MariaDB.
- #811: Add an "access_token" option to the ntfy monitoring hook for authenticating
without username/password. - #827: When the "--json" flag is given, suppress console escape codes so as not to
interfere with JSON output. - #829: Fix "--override" values containing deprecated section headers not actually overriding
configuration options under deprecated section headers. - #835: Add support for the NO_COLOR environment variable. See the documentation for more
information:
https://torsion.org/borgmatic/docs/how-to/set-up-backups/#colored-output - #839: Add log sending for the Apprise logging hook, enabled by default. See the documentation for
more information:
https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#apprise-hook - #839: Document a potentially breaking shell quoting edge case within error hooks:
https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#error-hooks - #840: When running the "rcreate" action and the repository already exists but with a different
encryption mode than requested, error. - Switch from Drone to Gitea Actions for continuous integration.
- Rename scripts/run-end-to-end-dev-tests to scripts/run-end-to-end-tests and use it in both dev
and CI for better dev-CI parity. - Clarify documentation about restoring a database: borgmatic does not create the database upon
restore.
borgmatic 1.8.8
- #370: For the PostgreSQL hook, pass the "PGSSLMODE" environment variable through to Borg when the
database's configuration omits the "ssl_mode" option. - #818: Allow the "--repository" flag to match across multiple configuration files.
- #820: Fix broken repository detection in the "rcreate" action with Borg 1.4. The issue did not
occur with other versions of Borg. - #822: Fix broken escaping logic in the PostgreSQL hook's "pg_dump_command" option.
- SECURITY: Prevent additional shell injection attacks within the PostgreSQL hook.
borgmatic 1.8.7
- #736: Store included configuration files within each backup archive in support of the "config
bootstrap" action. Previously, only top-level configuration files were stored. - #798: Elevate specific Borg warnings to errors or squash errors to
- warnings. See the documentation for more information:
https://torsion.org/borgmatic/docs/how-to/customize-warnings-and-errors/ - #810: SECURITY: Prevent shell injection attacks within the PostgreSQL hook, the MongoDB hook, the
SQLite hook, the "borgmatic borg" action, and command hook variable/constant interpolation. - #814: Fix a traceback when providing an invalid "--override" value for a list option.
borgmatic 1.8.6
- #767: Add an "--ssh-command" flag to the "config bootstrap" action for setting a custom SSH
command, as no configuration is available (including the "ssh_command" option) until
bootstrapping completes. - #794: Fix a traceback when the "repositories" option contains both strings and key/value pairs.
- #800: Add configured repository labels to the JSON output for all actions.
- #802: The "check --force" flag now runs checks even if "check" is in "skip_actions".
- #804: Validate the configured action names in the "skip_actions" option.
- #807: Stream SQLite databases directly to Borg instead of dumping to an intermediate file.
- When logging commands that borgmatic executes, log the environment variables that
borgmatic sets for those commands. (But don't log their values, since they often contain
passwords.)
borgmatic 1.8.5
- #701: Add a "skip_actions" option to skip running particular actions, handy for append-only or
checkless configurations. See the documentation for more information:
https://torsion.org/borgmatic/docs/how-to/set-up-backups/#skipping-actions - #701: Deprecate the "disabled" value for the "checks" option in favor of the new "skip_actions"
option. - #745: Constants now apply to included configuration, not just the file doing the includes. As a
side effect of this change, constants no longer apply to option names and only substitute into
configuration values. - #779: Add a "--match-archives" flag to the "check" action for selecting the archives to check,
overriding the existing "archive_name_format" and "match_archives" options in configuration. - #779: Only parse "--override" values as complex data types when they're for options of those
types. - #782: Fix environment variable interpolation within configured repository paths.
- #782: Add configuration constant overriding via the existing "--override" flag.
- #783: Upgrade ruamel.yaml dependency to support version 0.18.x.
- #784: Drop support for Python 3.7, which has been end-of-lifed.
borgmatic 1.8.4
- #715: Add a monitoring hook for sending backup status to a variety of monitoring services via the
Apprise library. See the documentation for more information:
https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#apprise-hook - #748: When an archive filter causes no matching archives for the "rlist" or "info"
actions, warn the user and suggest how to remove the filter. - #768: Fix a traceback when an invalid command-line flag or action is used.
- #771: Fix normalization of deprecated sections ("location:", "storage:", "hooks:", etc.) to
support empty sections without erroring. - #774: Disallow the "--dry-run" flag with the "borg" action, as borgmatic can't guarantee the Borg
command won't have side effects.
borgmatic 1.8.3
- #665: BREAKING: Simplify logging logic as follows: Syslog verbosity is now disabled by
default, but setting the "--syslog-verbosity" flag enables it regardless of whether you're at an
interactive console. Additionally, "--log-file-verbosity" and "--monitoring-verbosity" now
default to 1 (info about steps borgmatic is taking) instead of 0. And both syslog logging and
file logging can be enabled simultaneously. - #743: Add a monitoring hook for sending backup status and logs to Grafana Loki. See the
documentation for more information:
https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#loki-hook - #753: When "archive_name_format" is not set, filter archives using the default archive name
format. - #754: Fix error handling to log command output as one record per line instead of truncating
too-long output and swallowing the end of some Borg error messages. - #757: Update documentation so "sudo borgmatic" works for pipx borgmatic installations.
- #761: Fix for borgmatic not stopping Borg immediately when the user presses ctrl-C.
- Update documentation to recommend installing/upgrading borgmatic with pipx instead of pip. See the
documentation for more information:
https://torsion.org/borgmatic/docs/how-to/set-up-backups/#installation
https://torsion.org/borgmatic/docs/how-to/upgrade/#upgrading-borgmatic