borgmatic-collective/borgmatic
borgmatic-collective/borgmatic
Watch
9
74
Fork
You've already forked borgmatic
 57
Code Issues 71 Pull requests 3 Releases 162 Packages 1 Activity Actions 1

borgmatic diff uses arguments that borg does not understand #1327

New issue
Closed
opened 2026-06-24 14:18:27 +00:00 by agross · 3 comments
agross commented 2026-06-24 14:18:27 +00:00
Copy link

What I'm trying to do and why

I want to diff 2 archives.

I have exclude_if_present: ['.nobackup'] im my borgmatic yaml:

$ sudo borgmatic -c /etc/borgmatic.d/nextcloud.yaml diff --archive latest --second-archive cloud-nextcloud-2026-06-23T01:33:17 -v 2
/etc/borgmatic.d/nextcloud.yaml: Borg 1.4.4
ssh://u619662-sub2@u619662-sub2.your-storagebox.de:23/./cloud: BORG_RSH=*** BORG_PASSPHRASE_FD=*** BORG_RELOCATED_REPO_ACCESS_IS_OK=*** BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=*** BORG_EXIT_CODES=*** borg diff --log-json --lock-wait 5 --debug --show-rc --exclude-caches --exclude-if-present .nobackup --keep-exclude-tags --numeric-ids ssh://u619662-sub2@u619662-sub2.your-storagebox.de:23/./cloud::cloud-nextcloud-2026-06-24T01:42:15 cloud-nextcloud-2026-06-23T01:33:17
usage: borg diff [-h] [--critical] [--error] [--warning] [--info] [--debug]
                 [--debug-topic TOPIC] [-p] [--iec] [--log-json]
                 [--lock-wait SECONDS] [--bypass-lock] [--show-version]
                 [--show-rc] [--umask M] [--remote-path PATH]
                 [--remote-ratelimit RATE] [--upload-ratelimit RATE]
                 [--remote-buffer UPLOAD_BUFFER]
                 [--upload-buffer UPLOAD_BUFFER] [--consider-part-files]
                 [--debug-profile FILE] [--rsh RSH] [--numeric-owner]
                 [--numeric-ids] [--same-chunker-params] [--sort]
                 [--sort-by FIELD[,FIELD...]] [--content-only] [--json-lines]
                 [-e PATTERN] [--exclude-from EXCLUDEFILE] [--pattern PATTERN]
                 [--patterns-from PATTERNFILE]
                 REPO::ARCHIVE1 ARCHIVE2 [PATH ...]
borg diff: error: argument REPO::ARCHIVE1: ".nobackup": No archive specified

After commenting exclude_if_present:

$ sudo borgmatic -c /etc/borgmatic.d/nextcloud.yaml diff --archive latest --second-archive cloud-nextcloud-2026-06-23T01:33:17 -v 2
...
BORG_EXIT_CODES=*** borg diff --log-json --lock-wait 5 --debug --show-rc --exclude-caches --keep-exclude-tags --numeric-ids ssh://u619662-sub2@u619662-sub2.your-storagebox.de:23/./cloud::cloud-nextcloud-2026-06-24T01:42:15 cloud-nextcloud-2026-06-23T01:33:17
usage: borg [-V] [-h] [--critical] [--error] [--warning] [--info] [--debug]
            [--debug-topic TOPIC] [-p] [--iec] [--log-json]
            [--lock-wait SECONDS] [--bypass-lock] [--show-version] [--show-rc]
            [--umask M] [--remote-path PATH] [--remote-ratelimit RATE]
            [--upload-ratelimit RATE] [--remote-buffer UPLOAD_BUFFER]
            [--upload-buffer UPLOAD_BUFFER] [--consider-part-files]
            [--debug-profile FILE] [--rsh RSH]
            <command> ...
borg: error: unrecognized arguments: --exclude-caches --keep-exclude-tags

After commenting exclude_caches: true and keep_exclude_tags: true the command finally runs.

Steps to reproduce

Configure exclude_caches: true, keep_exclude_tags: true or exclude_if_present: ['something']

Actual behavior

No response

Expected behavior

Works without messing with config files first.

Other notes / implementation ideas

No response

borgmatic version

2.1.6

borgmatic installation method

dnf

Borg version

1.4.4

Python version

Python 3.14.6

Database version (if applicable)

No response

Operating system and version

Fedora

### What I'm trying to do and why I want to diff 2 archives. I have `exclude_if_present: ['.nobackup']` im my borgmatic yaml: ``` $ sudo borgmatic -c /etc/borgmatic.d/nextcloud.yaml diff --archive latest --second-archive cloud-nextcloud-2026-06-23T01:33:17 -v 2 /etc/borgmatic.d/nextcloud.yaml: Borg 1.4.4 ssh://u619662-sub2@u619662-sub2.your-storagebox.de:23/./cloud: BORG_RSH=*** BORG_PASSPHRASE_FD=*** BORG_RELOCATED_REPO_ACCESS_IS_OK=*** BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=*** BORG_EXIT_CODES=*** borg diff --log-json --lock-wait 5 --debug --show-rc --exclude-caches --exclude-if-present .nobackup --keep-exclude-tags --numeric-ids ssh://u619662-sub2@u619662-sub2.your-storagebox.de:23/./cloud::cloud-nextcloud-2026-06-24T01:42:15 cloud-nextcloud-2026-06-23T01:33:17 usage: borg diff [-h] [--critical] [--error] [--warning] [--info] [--debug] [--debug-topic TOPIC] [-p] [--iec] [--log-json] [--lock-wait SECONDS] [--bypass-lock] [--show-version] [--show-rc] [--umask M] [--remote-path PATH] [--remote-ratelimit RATE] [--upload-ratelimit RATE] [--remote-buffer UPLOAD_BUFFER] [--upload-buffer UPLOAD_BUFFER] [--consider-part-files] [--debug-profile FILE] [--rsh RSH] [--numeric-owner] [--numeric-ids] [--same-chunker-params] [--sort] [--sort-by FIELD[,FIELD...]] [--content-only] [--json-lines] [-e PATTERN] [--exclude-from EXCLUDEFILE] [--pattern PATTERN] [--patterns-from PATTERNFILE] REPO::ARCHIVE1 ARCHIVE2 [PATH ...] borg diff: error: argument REPO::ARCHIVE1: ".nobackup": No archive specified ``` After commenting `exclude_if_present`: ``` $ sudo borgmatic -c /etc/borgmatic.d/nextcloud.yaml diff --archive latest --second-archive cloud-nextcloud-2026-06-23T01:33:17 -v 2 ... BORG_EXIT_CODES=*** borg diff --log-json --lock-wait 5 --debug --show-rc --exclude-caches --keep-exclude-tags --numeric-ids ssh://u619662-sub2@u619662-sub2.your-storagebox.de:23/./cloud::cloud-nextcloud-2026-06-24T01:42:15 cloud-nextcloud-2026-06-23T01:33:17 usage: borg [-V] [-h] [--critical] [--error] [--warning] [--info] [--debug] [--debug-topic TOPIC] [-p] [--iec] [--log-json] [--lock-wait SECONDS] [--bypass-lock] [--show-version] [--show-rc] [--umask M] [--remote-path PATH] [--remote-ratelimit RATE] [--upload-ratelimit RATE] [--remote-buffer UPLOAD_BUFFER] [--upload-buffer UPLOAD_BUFFER] [--consider-part-files] [--debug-profile FILE] [--rsh RSH] <command> ... borg: error: unrecognized arguments: --exclude-caches --keep-exclude-tags ``` After commenting `exclude_caches: true` and `keep_exclude_tags: true` the command finally runs. ### Steps to reproduce Configure `exclude_caches: true`, `keep_exclude_tags: true` or `exclude_if_present: ['something']` ### Actual behavior _No response_ ### Expected behavior Works without messing with config files first. ### Other notes / implementation ideas _No response_ ### borgmatic version 2.1.6 ### borgmatic installation method dnf ### Borg version 1.4.4 ### Python version Python 3.14.6 ### Database version (if applicable) _No response_ ### Operating system and version Fedora
callegar commented 2026-07-19 10:29:23 +00:00
Copy link

Experiencing the same behavior here also with borgmatic 2.1.6. Diff should automatically refrain from adding to the borg diff command line those arguments that borg diff cannot understand. Currently borgmatic diff is broken with most configurations, but creating the "parameter filter" should fix it, thanks for the tool!

Experiencing the same behavior here also with borgmatic 2.1.6. Diff should automatically refrain from adding to the borg diff command line those arguments that borg diff cannot understand. Currently `borgmatic diff` is broken with most configurations, but creating the "parameter filter" should fix it, thanks for the tool!
witten commented 2026-07-20 01:59:26 +00:00
Owner
Copy link

@agross thanks for filing this! And thanks to @callegar as well for weighing in. This issue is now fixed in main and will be part of the next release. Let me know if you find any other configuration options that break the diff action.. I found and fixed three others as part of this ticket, all of them related to excludes.

@agross thanks for filing this! And thanks to @callegar as well for weighing in. This issue is now fixed in main and will be part of the next release. Let me know if you find any other configuration options that break the `diff` action.. I found and fixed three others as part of this ticket, all of them related to excludes.
witten commented 2026-08-14 20:17:41 +00:00
Owner
Copy link

Released in borgmatic 2.1.7!

Released in borgmatic 2.1.7!
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
parallel-borgmatic
command-hook-steps
2.1.7
2.1.6
2.1.5
2.1.4
2.1.3
2.1.2
2.1.1
2.1.0
2.0.13
2.0.12
2.0.11
2.0.10
2.0.9
2.0.8
2.0.7
2.0.6
2.0.5
2.0.4
2.0.3
2.0.2
2.0.1
2.0.0
1.9.14
1.9.13
1.9.12
1.9.11
1.9.10
1.9.9
1.9.8
1.9.7
1.9.6
1.9.5
1.9.4
1.9.3
1.9.2
1.9.1
1.9.0
1.8.14
1.8.13
1.8.12
1.8.11
1.8.10
1.8.9
1.8.8
1.8.7
1.8.6
1.8.5
1.8.4
1.8.3
1.8.2
1.8.1
1.8.0
1.7.15
1.7.14
1.7.13
1.7.12
1.7.11
1.7.10
1.7.9
1.7.8
1.7.7
1.7.6
1.7.5
1.7.4
1.7.3
1.7.2
1.7.1
1.7.0
1.6.6
1.6.5
1.6.4
1.6.3
1.6.2
1.6.1
1.6.0
1.5.24
1.5.23
1.5.22
1.5.21
1.5.20
1.5.19
1.5.18
1.5.17
1.5.16
1.5.15
1.5.14
1.5.13
1.5.12
1.5.11
1.5.10
1.5.9
1.5.8
1.5.7
1.5.7.dev0
1.5.6
1.5.5
1.5.4
1.5.3
1.5.2
1.5.1
1.5.0
1.4.22
1.4.21
1.4.20
1.4.19
1.4.18
1.4.17
1.4.16
1.4.15
1.4.14
1.4.13
1.4.12
1.4.11
1.4.10
1.4.9
1.4.8
1.4.7
1.4.6
1.4.5
1.4.4
1.4.3
1.4.2
1.4.1
1.4.0
1.3.26
1.3.25
1.3.24
1.3.23
1.3.22
1.3.21
1.3.20
1.3.19
1.3.18
1.3.17
1.3.16
1.3.15
1.3.14
1.3.13
1.3.12
1.3.11
1.3.10
1.3.9
1.3.8
1.3.7
1.3.6
1.3.5
1.3.4
1.3.3
1.3.2
1.3.1
1.3.0
1.2.18
1.2.17
1.2.16
1.2.15
1.2.14
1.2.13
1.2.12
1.2.11
1.2.10
1.2.9
1.2.8
1.2.7
1.2.6
1.2.5
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.15
1.1.14
1.1.13
1.1.12
1.1.11
1.1.10
1.1.9
1.1.7
1.1.6
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.3
1.0.2
1.0.1
1.0.0
0.1.8
0.1.7
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0
0.0.7
0.0.6
0.0.5
0.0.4
0.0.3
0.0.2
Labels
Clear labels   
blocked

   
breaking

   
bug

   
data loss

   
design finalized

   
good first issue

   
new feature area

   
question / support

   
security

   
waiting for response
No labels
blocked
breaking
bug
data loss
design finalized
good first issue
new feature area
question / support
security
waiting for response
Milestone
Clear milestone
No items
No milestone
Assignees
Clear assignees
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
borgmatic-collective/borgmatic#1327
No description provided.