1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
borgmatic (1.9.14-0.1) unstable; urgency=medium
Here is a list of breaking changes since bookworm version 1.7.7.
For an exhautive changelog please refer to:
/usr/share/doc/borgmatic/changelog.gz
----------------------------------------------------------------
1.9.3
* deprecate the "store_config_files" option at the global scope and move it under the "bootstrap"
hook. see the documentation for more information:
https://torsion.org/borgmatic/docs/how-to/extract-a-backup/#extract-the-configuration-files-used-to-create-an-archive
1.9.2
* #722: remove the restriction that the "extract" and "mount" actions must match a single
repository. now they work more like other actions, where each repository is applied in turn.
1.9.0
* #609: breaking: apply the "working_directory" option to all actions, not just "create". this
includes repository paths, destination paths, mount points, etc.
* #562: deprecate the "borgmatic_source_directory" option in favor of "user_runtime_directory"
and "user_state_directory".
* #562: breaking: move the default borgmatic streaming database dump and bootstrap metadata
directory from ~/.borgmatic to /run/user/$uid/borgmatic, which is more xdg-compliant. you can
override this location with the new "user_runtime_directory" option. existing archives with
database dumps at the old location are still restorable.
* #562, #638: move the default check state directory from ~/.borgmatic to
~/.local/state/borgmatic. this is more xdg-compliant and also prevents these state files from
getting backed up (unless you explicitly include them). you can override this location with the
new "user_state_directory" option. after the first time you run the "check" action with borgmatic
1.9.0, you can safely delete the ~/.borgmatic directory.
* #838: breaking: with borg 1.4+, store database dumps and bootstrap metadata in a "/borgmatic"
directory within a backup archive, so the path doesn't depend on the current user. this means
that you can now backup as one user and restore or bootstrap as another user, among other use
cases.
* #915: breaking: rename repository actions like "rcreate" to more explicit names like
"repo-create" for compatibility with recent changes in borg 2.0.0b10.
* #918: breaking: when databases are configured, don't auto-enable the "one_file_system" option,
as existing auto-excludes of special files should be sufficient to prevent borg from hanging on
them. but if this change causes problems for you, you can always enable "one_file_system"
explicitly.
* #921: breaking: change soft failure command hooks to skip only the current repository rather than
all repositories in the configuration file.
* when using borg 2, default the "archive_name_format" option to just "{hostname}", as borg 2 does
not require unique archive names; identical archive names form a common "series" that can be
targeted together. see the borg 2 documentation for more information:
https://borgbackup.readthedocs.io/en/2.0.0b13/changes.html#borg-1-2-x-1-4-x-to-borg-2-0
1.8.5
* #701: deprecate the "disabled" value for the "checks" option in favor of the new "skip_actions"
option.
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.
1.8.0
* #575: breaking: for the "borgmatic borg" action, instead of implicitly injecting
repository/archive into the resulting borg command-line, pass repository to borg via an
environment variable and make archive available for explicit use in your commands. see the
documentation for more information:
https://torsion.org/borgmatic/docs/how-to/run-arbitrary-borg-commands/
* #721: remove configuration sections ("location:", "storage:", "hooks:", etc.), while still
keeping deprecated support for them. now, all options are at the same level, and you don't need
to worry about commenting/uncommenting section headers when you change an option (if you remove
your sections first).
* #721: breaking: the retention prefix and the consistency prefix can no longer have different
values (unless one is not set).
* #721: breaking: the storage umask and the hooks umask can no longer have different values (unless
one is not set).
* breaking: flags like "--config" that previously took multiple values now need to be given once
per value, e.g. "--config first.yaml --config second.yaml" instead of "--config first.yaml
second.yaml". this prevents argument parsing errors on ambiguous commands.
* breaking: remove the deprecated (and silently ignored) "--successful" flag on the "list" action,
as newer versions of borg list successful (non-checkpoint) archives by default.
* all deprecated configuration option values now generate warning logs.
* remove the deprecated (and non-functional) "--excludes" flag in favor of excludes within
configuration.
1.7.15
* #529: deprecate generate-borgmatic-config in favor of new "config generate" action.
* #529: deprecate validate-borgmatic-config in favor of new "config validate" action.
* #697, #712, #716: extract borgmatic configuration from backup via new "config bootstrap"
action—even when borgmatic has no configuration yet!
1.7.11
* #479, #588: breaking: automatically use the "archive_name_format" option to filter which archives
get used for borgmatic actions that operate on multiple archives. override this behavior with the
new "match_archives" option in the storage section. this change is "breaking" in that it silently
changes which archives get considered for "rlist", "prune", "check", etc. see the documentation
for more information:
https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#archive-naming
* #479, #588: the "prefix" options have been deprecated in favor of the new "archive_name_format"
auto-matching behavior and the "match_archives" option.
1.7.9
* #304: change the default action order when no actions are specified on the command-line to:
"create", "prune", "compact", "check". if you'd like to retain the old ordering ("prune" and
"compact" first), then specify actions explicitly on the command-line.
* #304: run any command-line actions in the order specified instead of using a fixed ordering.
----------------------------------------------------------------
-- Geoffroy Youri Berret <kaliko@debian.org> Sat, 22 Mar 2025 09:05:37 +0100
borgmatic (1.9.13-0.1) unstable; urgency=medium
Check official documentation regarding upgrades:
https://torsion.org/borgmatic/docs/how-to/upgrade/
You can fetch upstream documention running:
/usr/share/doc/borgmatic/borgmatic-doc-download.sh
-- Geoffroy Youri Berret <kaliko@debian.org> Wed, 05 Mar 2025 11:17:51 +0100
borgmatic (1.9.0-0.1) unstable; urgency=medium
borgmatic now conditionally starts when a yaml configuration file is found in
/etc/borgmatic/config.yaml or /etc/borgmatic.d/*yaml following borgmatic convention.
Inspect unit for details and test conditions with systemd-analyze:
systemd-analyze condition \
'ConditionFileNotEmpty=|/etc/borgmatic/config.yaml' \
'ConditionPathExistsGlob=|/etc/borgmatic.d/*.yaml'
See upstream documentation for more:
https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/
-- Geoffroy Youri Berret <kaliko@debian.org> Mon, 14 Oct 2024 10:11:59 +0200
|
