borgmatic --verbose doesn't work as one would expect. #1277

New issue

Open

opened 2026-03-02 03:54:56 +00:00 by gosseljl · 1 comment

gosseljl commented

2026-03-02 03:54:56 +00:00

What I'm trying to do and why

I'm trying to figure out why my backups are failing. The natural course of action here in my mind is to run the command with the --verbose flag. Instead I get a multi page scroll of options the command takes. This is not helpful.

Steps to reproduce

Run borgmatic --verbose

When in this state even just running borgmatic returns nothing and an exit code of 0.

Actual behavior

borgmatic --verbose
usage: borgmatic [-h] [-c CONFIG_PATHS] [-n] [--override OPTION.SUBOPTION=VALUE] [--no-environment-interpolation] [--bash-completion] [--fish-completion] [--version]
[--after-actions[0] AFTER_ACTIONS[0]] [--after-actions AFTER_ACTIONS] [--after-backup[0] AFTER_BACKUP[0]] [--after-backup AFTER_BACKUP]
[--after-check[0] AFTER_CHECK[0]] [--after-check AFTER_CHECK] [--after-compact[0] AFTER_COMPACT[0]] [--after-compact AFTER_COMPACT]
[--after-everything[0] AFTER_EVERYTHING[0]] [--after-everything AFTER_EVERYTHING] [--after-extract[0] AFTER_EXTRACT[0]] [--after-extract AFTER_EXTRACT]
[--after-prune[0] AFTER_PRUNE[0]] [--after-prune AFTER_PRUNE] [--apprise.fail.body BODY] [--apprise.fail.title TITLE] [--apprise.finish.body BODY]
[--apprise.finish.title TITLE] [--apprise.log.body BODY] [--apprise.log.title TITLE] [--apprise.logs-size-limit LOGS_SIZE_LIMIT] [--apprise.send-logs]
[--apprise.no-send-logs] [--apprise.services[0].label LABEL] [--apprise.services[0].url URL] [--apprise.services SERVICES] [--apprise.start.body BODY]
[--apprise.start.title TITLE] [--apprise.states[0] STATES[0]] [--apprise.states STATES] [--archive-name-format ARCHIVE_NAME_FORMAT] [--atime] [--no-atime]
[--before-actions[0] BEFORE_ACTIONS[0]] [--before-actions BEFORE_ACTIONS] [--before-backup[0] BEFORE_BACKUP[0]] [--before-backup BEFORE_BACKUP]
[--before-check[0] BEFORE_CHECK[0]] [--before-check BEFORE_CHECK] [--before-compact[0] BEFORE_COMPACT[0]] [--before-compact BEFORE_COMPACT]
[--before-everything[0] BEFORE_EVERYTHING[0]] [--before-everything BEFORE_EVERYTHING] [--before-extract[0] BEFORE_EXTRACT[0]] [--before-extract BEFORE_EXTRACT]
[--before-prune[0] BEFORE_PRUNE[0]] [--before-prune BEFORE_PRUNE] [--birthtime] [--no-birthtime] [--bootstrap.store-config-files] [--bootstrap.no-store-config-files]
[--borg-base-directory BORG_BASE_DIRECTORY] [--borg-cache-directory BORG_CACHE_DIRECTORY] [--borg-config-directory BORG_CONFIG_DIRECTORY]
[--borg-exit-codes[0].code CODE] [--borg-exit-codes[0].treat-as TREAT_AS] [--borg-exit-codes BORG_EXIT_CODES] [--borg-files-cache-ttl BORG_FILES_CACHE_TTL]
[--borg-key-file BORG_KEY_FILE] [--borg-keys-directory BORG_KEYS_DIRECTORY] [--borg-security-directory BORG_SECURITY_DIRECTORY]
[--borgmatic-source-directory BORGMATIC_SOURCE_DIRECTORY] [--btrfs.btrfs-command BTRFS_COMMAND] [--btrfs.findmnt-command FINDMNT_COMMAND]
[--check-i-know-what-i-am-doing] [--no-check-i-know-what-i-am-doing] [--check-last CHECK_LAST] [--check-repositories[0] CHECK_REPOSITORIES[0]]
[--check-repositories CHECK_REPOSITORIES] [--checkpoint-interval CHECKPOINT_INTERVAL] [--checkpoint-volume CHECKPOINT_VOLUME] [--checks[0].frequency FREQUENCY]
[--checks[0].count-tolerance-percentage COUNT_TOLERANCE_PERCENTAGE] [--checks[0].name NAME] [--checks[0].max-duration MAX_DURATION]
[--checks[0].data-sample-percentage DATA_SAMPLE_PERCENTAGE] [--checks[0].only-run-on[0] ONLY_RUN_ON[0]] [--checks[0].only-run-on ONLY_RUN_ON]
[--checks[0].data-tolerance-percentage DATA_TOLERANCE_PERCENTAGE] [--checks[0].xxh64sum-command XXH64SUM_COMMAND] [--checks CHECKS] [--chunker-params CHUNKER_PARAMS]
[--color] [--no-color] [--commands[0].before BEFORE] [--commands[0].after AFTER] [--commands[0].run[0] RUN[0]] [--commands[0].run RUN] [--commands[0].when[0] WHEN[0]]
[--commands[0].when WHEN] [--commands[0].states[0] STATES[0]] [--commands[0].states STATES] [--commands COMMANDS] [--compact-threshold COMPACT_THRESHOLD]
[--compression COMPRESSION] [--constants CONSTANTS] [--container.secrets-directory SECRETS_DIRECTORY] [--cronhub.ping-url PING_URL] [--cronitor.ping-url PING_URL]
[--ctime] [--no-ctime] [--debug-passphrase] [--no-debug-passphrase] [--default-actions] [--no-default-actions] [--display-passphrase] [--no-display-passphrase]
[--encryption-passcommand ENCRYPTION_PASSCOMMAND] [--encryption-passphrase ENCRYPTION_PASSPHRASE] [--exclude-caches] [--no-exclude-caches]
[--exclude-from[0] EXCLUDE_FROM[0]] [--exclude-from EXCLUDE_FROM] [--exclude-if-present[0] EXCLUDE_IF_PRESENT[0]] [--exclude-if-present EXCLUDE_IF_PRESENT]
[--exclude-nodump] [--no-exclude-nodump] [--exclude-patterns[0] EXCLUDE_PATTERNS[0]] [--exclude-patterns EXCLUDE_PATTERNS]
[--extra-borg-options.break-lock BREAK_LOCK] [--extra-borg-options.check CHECK] [--extra-borg-options.compact COMPACT] [--extra-borg-options.create CREATE]
[--extra-borg-options.delete DELETE] [--extra-borg-options.export-tar EXPORT_TAR] [--extra-borg-options.extract EXTRACT] [--extra-borg-options.info INFO]
[--extra-borg-options.init INIT] [--extra-borg-options.key-change-passphrase KEY_CHANGE_PASSPHRASE] [--extra-borg-options.key-export KEY_EXPORT]
[--extra-borg-options.key-import KEY_IMPORT] [--extra-borg-options.list LIST] [--extra-borg-options.mount MOUNT] [--extra-borg-options.prune PRUNE]
[--extra-borg-options.recreate RECREATE] [--extra-borg-options.rename RENAME] [--extra-borg-options.repo-create REPO_CREATE]
[--extra-borg-options.repo-delete REPO_DELETE] [--extra-borg-options.repo-info REPO_INFO] [--extra-borg-options.repo-list REPO_LIST]
[--extra-borg-options.transfer TRANSFER] [--extra-borg-options.umount UMOUNT] [--files-cache FILES_CACHE] [--flags] [--no-flags] [--healthchecks.create-slug]
[--healthchecks.no-create-slug] [--healthchecks.ping-body-limit PING_BODY_LIMIT] [--healthchecks.ping-url PING_URL] [--healthchecks.send-logs]
[--healthchecks.no-send-logs] [--healthchecks.states[0] STATES[0]] [--healthchecks.states STATES] [--healthchecks.verify-tls] [--healthchecks.no-verify-tls]
[--keep-13weekly KEEP_13WEEKLY] [--keep-3monthly KEEP_3MONTHLY] [--keep-daily KEEP_DAILY] [--keep-exclude-tags] [--no-keep-exclude-tags] [--keep-hourly KEEP_HOURLY]
[--keep-minutely KEEP_MINUTELY] [--keep-monthly KEEP_MONTHLY] [--keep-secondly KEEP_SECONDLY] [--keep-weekly KEEP_WEEKLY] [--keep-within KEEP_WITHIN]
[--keep-yearly KEEP_YEARLY] [--keepassxc.ask-for-password] [--keepassxc.no-ask-for-password] [--keepassxc.keepassxc-cli-command KEEPASSXC_CLI_COMMAND]
[--keepassxc.key-file KEY_FILE] [--keepassxc.yubikey YUBIKEY] [--local-path LOCAL_PATH] [--lock-wait LOCK_WAIT] [--log-file LOG_FILE]
[--log-file-format LOG_FILE_FORMAT] [--log-file-verbosity LOG_FILE_VERBOSITY] [--log-json] [--no-log-json] [--loki.labels LABELS] [--loki.send-logs]
[--loki.no-send-logs] [--loki.url URL] [--lvm.lsblk-command LSBLK_COMMAND] [--lvm.lvcreate-command LVCREATE_COMMAND] [--lvm.lvremove-command LVREMOVE_COMMAND]
[--lvm.lvs-command LVS_COMMAND] [--lvm.mount-command MOUNT_COMMAND] [--lvm.snapshot-size SNAPSHOT_SIZE] [--lvm.umount-command UMOUNT_COMMAND]
[--mariadb-databases[0].add-drop-database] [--mariadb-databases[0].no-add-drop-database] [--mariadb-databases[0].container CONTAINER]
[--mariadb-databases[0].format FORMAT] [--mariadb-databases[0].hostname HOSTNAME] [--mariadb-databases[0].label LABEL]
[--mariadb-databases[0].list-options LIST_OPTIONS] [--mariadb-databases[0].mariadb-command MARIADB_COMMAND]
[--mariadb-databases[0].mariadb-dump-command MARIADB_DUMP_COMMAND] [--mariadb-databases[0].name NAME] [--mariadb-databases[0].options OPTIONS]
[--mariadb-databases[0].password PASSWORD] [--mariadb-databases[0].password-transport PASSWORD_TRANSPORT] [--mariadb-databases[0].port PORT]
[--mariadb-databases[0].restore-container RESTORE_CONTAINER] [--mariadb-databases[0].restore-hostname RESTORE_HOSTNAME]
[--mariadb-databases[0].restore-options RESTORE_OPTIONS] [--mariadb-databases[0].restore-password RESTORE_PASSWORD] [--mariadb-databases[0].restore-port RESTORE_PORT]
[--mariadb-databases[0].restore-socket-path RESTORE_SOCKET_PATH] [--mariadb-databases[0].restore-tls] [--mariadb-databases[0].no-restore-tls]
[--mariadb-databases[0].restore-username RESTORE_USERNAME] [--mariadb-databases[0].skip-names[0] SKIP_NAMES[0]] [--mariadb-databases[0].skip-names SKIP_NAMES]
[--mariadb-databases[0].socket-path SOCKET_PATH] [--mariadb-databases[0].tls] [--mariadb-databases[0].no-tls] [--mariadb-databases[0].username USERNAME]
[--mariadb-databases MARIADB_DATABASES] [--mongodb-databases[0].authentication-database AUTHENTICATION_DATABASE] [--mongodb-databases[0].container CONTAINER]
[--mongodb-databases[0].format FORMAT] [--mongodb-databases[0].hostname HOSTNAME] [--mongodb-databases[0].label LABEL]
[--mongodb-databases[0].mongodump-command MONGODUMP_COMMAND] [--mongodb-databases[0].mongorestore-command MONGORESTORE_COMMAND] [--mongodb-databases[0].name NAME]
[--mongodb-databases[0].options OPTIONS] [--mongodb-databases[0].password PASSWORD] [--mongodb-databases[0].port PORT]
[--mongodb-databases[0].restore-container RESTORE_CONTAINER] [--mongodb-databases[0].restore-hostname RESTORE_HOSTNAME]
[--mongodb-databases[0].restore-options RESTORE_OPTIONS] [--mongodb-databases[0].restore-password RESTORE_PASSWORD] [--mongodb-databases[0].restore-port RESTORE_PORT]
[--mongodb-databases[0].restore-username RESTORE_USERNAME] [--mongodb-databases[0].username USERNAME] [--mongodb-databases MONGODB_DATABASES]
[--monitoring-verbosity MONITORING_VERBOSITY] [--mysql-databases[0].add-drop-database] [--mysql-databases[0].no-add-drop-database]
[--mysql-databases[0].container CONTAINER] [--mysql-databases[0].format FORMAT] [--mysql-databases[0].hostname HOSTNAME] [--mysql-databases[0].label LABEL]
[--mysql-databases[0].list-options LIST_OPTIONS] [--mysql-databases[0].mysql-command MYSQL_COMMAND] [--mysql-databases[0].mysql-dump-command MYSQL_DUMP_COMMAND]
[--mysql-databases[0].name NAME] [--mysql-databases[0].options OPTIONS] [--mysql-databases[0].password PASSWORD]
[--mysql-databases[0].password-transport PASSWORD_TRANSPORT] [--mysql-databases[0].port PORT] [--mysql-databases[0].restore-container RESTORE_CONTAINER]
[--mysql-databases[0].restore-hostname RESTORE_HOSTNAME] [--mysql-databases[0].restore-options RESTORE_OPTIONS]
[--mysql-databases[0].restore-password RESTORE_PASSWORD] [--mysql-databases[0].restore-port RESTORE_PORT]
[--mysql-databases[0].restore-socket-path RESTORE_SOCKET_PATH] [--mysql-databases[0].restore-tls] [--mysql-databases[0].no-restore-tls]
[--mysql-databases[0].restore-username RESTORE_USERNAME] [--mysql-databases[0].skip-names[0] SKIP_NAMES[0]] [--mysql-databases[0].skip-names SKIP_NAMES]
[--mysql-databases[0].socket-path SOCKET_PATH] [--mysql-databases[0].tls] [--mysql-databases[0].no-tls] [--mysql-databases[0].username USERNAME]
[--mysql-databases MYSQL_DATABASES] [--ntfy.access-token ACCESS_TOKEN] [--ntfy.fail.message MESSAGE] [--ntfy.fail.priority PRIORITY] [--ntfy.fail.tags TAGS]
[--ntfy.fail.title TITLE] [--ntfy.finish.message MESSAGE] [--ntfy.finish.priority PRIORITY] [--ntfy.finish.tags TAGS] [--ntfy.finish.title TITLE]
[--ntfy.password PASSWORD] [--ntfy.server SERVER] [--ntfy.start.message MESSAGE] [--ntfy.start.priority PRIORITY] [--ntfy.start.tags TAGS] [--ntfy.start.title TITLE]
[--ntfy.states[0] STATES[0]] [--ntfy.states STATES] [--ntfy.topic TOPIC] [--ntfy.username USERNAME] [--numeric-ids] [--no-numeric-ids] [--on-error[0] ON_ERROR[0]]
[--on-error ON_ERROR] [--one-file-system] [--no-one-file-system] [--pagerduty.integration-key INTEGRATION_KEY] [--pagerduty.send-logs] [--pagerduty.no-send-logs]
[--patterns[0] PATTERNS[0]] [--patterns PATTERNS] [--patterns-from[0] PATTERNS_FROM[0]] [--patterns-from PATTERNS_FROM]
[--postgresql-databases[0].analyze-options ANALYZE_OPTIONS] [--postgresql-databases[0].compression COMPRESSION] [--postgresql-databases[0].container CONTAINER]
[--postgresql-databases[0].format FORMAT] [--postgresql-databases[0].hostname HOSTNAME] [--postgresql-databases[0].label LABEL]
[--postgresql-databases[0].list-options LIST_OPTIONS] [--postgresql-databases[0].name NAME] [--postgresql-databases[0].no-owner] [--postgresql-databases[0].owner]
[--postgresql-databases[0].options OPTIONS] [--postgresql-databases[0].password PASSWORD] [--postgresql-databases[0].pg-dump-command PG_DUMP_COMMAND]
[--postgresql-databases[0].pg-restore-command PG_RESTORE_COMMAND] [--postgresql-databases[0].port PORT] [--postgresql-databases[0].psql-command PSQL_COMMAND]
[--postgresql-databases[0].restore-container RESTORE_CONTAINER] [--postgresql-databases[0].restore-hostname RESTORE_HOSTNAME]
[--postgresql-databases[0].restore-options RESTORE_OPTIONS] [--postgresql-databases[0].restore-password RESTORE_PASSWORD]
[--postgresql-databases[0].restore-port RESTORE_PORT] [--postgresql-databases[0].restore-username RESTORE_USERNAME] [--postgresql-databases[0].ssl-cert SSL_CERT]
[--postgresql-databases[0].ssl-crl SSL_CRL] [--postgresql-databases[0].ssl-key SSL_KEY] [--postgresql-databases[0].ssl-mode SSL_MODE]
[--postgresql-databases[0].ssl-root-cert SSL_ROOT_CERT] [--postgresql-databases[0].username USERNAME] [--postgresql-databases POSTGRESQL_DATABASES] [--prefix PREFIX]
[--pushover.fail.device DEVICE] [--pushover.fail.expire EXPIRE] [--pushover.fail.html] [--pushover.fail.no-html] [--pushover.fail.message MESSAGE]
[--pushover.fail.priority PRIORITY] [--pushover.fail.retry RETRY] [--pushover.fail.sound SOUND] [--pushover.fail.title TITLE] [--pushover.fail.ttl TTL]
[--pushover.fail.url URL] [--pushover.fail.url-title URL_TITLE] [--pushover.finish.device DEVICE] [--pushover.finish.expire EXPIRE] [--pushover.finish.html]
[--pushover.finish.no-html] [--pushover.finish.message MESSAGE] [--pushover.finish.priority PRIORITY] [--pushover.finish.retry RETRY] [--pushover.finish.sound SOUND]
[--pushover.finish.title TITLE] [--pushover.finish.ttl TTL] [--pushover.finish.url URL] [--pushover.finish.url-title URL_TITLE] [--pushover.start.device DEVICE]
[--pushover.start.expire EXPIRE] [--pushover.start.html] [--pushover.start.no-html] [--pushover.start.message MESSAGE] [--pushover.start.priority PRIORITY]
[--pushover.start.retry RETRY] [--pushover.start.sound SOUND] [--pushover.start.title TITLE] [--pushover.start.ttl TTL] [--pushover.start.url URL]
[--pushover.start.url-title URL_TITLE] [--pushover.states[0] STATES[0]] [--pushover.states STATES] [--pushover.token TOKEN] [--pushover.user USER] [--read-special]
[--no-read-special] [--recompress RECOMPRESS] [--relocated-repo-access-is-ok] [--no-relocated-repo-access-is-ok] [--remote-path REMOTE_PATH]
[--repositories[0].append-only] [--repositories[0].no-append-only] [--repositories[0].encryption ENCRYPTION] [--repositories[0].label LABEL]
[--repositories[0].make-parent-directories] [--repositories[0].no-make-parent-directories] [--repositories[0].path PATH]
[--repositories[0].storage-quota STORAGE_QUOTA] [--repositories REPOSITORIES] [--retries RETRIES] [--retry-wait RETRY_WAIT]
[--sentry.data-source-name-url DATA_SOURCE_NAME_URL] [--sentry.environment ENVIRONMENT] [--sentry.monitor-slug MONITOR_SLUG] [--sentry.states[0] STATES[0]]
[--sentry.states STATES] [--skip-actions[0] SKIP_ACTIONS[0]] [--skip-actions SKIP_ACTIONS] [--source-directories[0] SOURCE_DIRECTORIES[0]]
[--source-directories SOURCE_DIRECTORIES] [--source-directories-must-exist] [--no-source-directories-must-exist] [--sqlite-databases[0].label LABEL]
[--sqlite-databases[0].name NAME] [--sqlite-databases[0].path PATH] [--sqlite-databases[0].restore-path RESTORE_PATH]
[--sqlite-databases[0].sqlite-command SQLITE_COMMAND] [--sqlite-databases[0].sqlite-restore-command SQLITE_RESTORE_COMMAND] [--sqlite-databases SQLITE_DATABASES]
[--ssh-command SSH_COMMAND] [--syslog-verbosity SYSLOG_VERBOSITY] [--systemd.encrypted-credentials-directory ENCRYPTED_CREDENTIALS_DIRECTORY]
[--systemd.systemd-creds-command SYSTEMD_CREDS_COMMAND] [--temporary-directory TEMPORARY_DIRECTORY] [--umask UMASK] [--unknown-unencrypted-repo-access-is-ok]
[--no-unknown-unencrypted-repo-access-is-ok] [--unsafe-skip-path-validation-before-create] [--no-unsafe-skip-path-validation-before-create]
[--upload-buffer-size UPLOAD_BUFFER_SIZE] [--upload-rate-limit UPLOAD_RATE_LIMIT] [--uptime-kuma.push-url PUSH_URL] [--uptime-kuma.states[0] STATES[0]]
[--uptime-kuma.states STATES] [--uptime-kuma.verify-tls] [--uptime-kuma.no-verify-tls] [--use-chunks-archive] [--no-use-chunks-archive]
[--user-runtime-directory USER_RUNTIME_DIRECTORY] [--user-state-directory USER_STATE_DIRECTORY] [-v VERBOSITY] [--working-directory WORKING_DIRECTORY]
[--zabbix.api-key API_KEY] [--zabbix.fail.value VALUE] [--zabbix.finish.value VALUE] [--zabbix.host HOST] [--zabbix.itemid ITEMID] [--zabbix.key KEY]
[--zabbix.password PASSWORD] [--zabbix.server SERVER] [--zabbix.start.value VALUE] [--zabbix.states[0] STATES[0]] [--zabbix.states STATES]
[--zabbix.username USERNAME] [--zfs.mount-command MOUNT_COMMAND] [--zfs.umount-command UMOUNT_COMMAND] [--zfs.zfs-command ZFS_COMMAND]
...
Unrecognized argument: --verbose

Need some help? https://torsion.org/borgmatic/#issues

Expected behavior

I would expect it to attempt a backup job and then fail and give me some diagnostic information I could act upon. The spew I get from the program is unhelpful and overwhelming.

Other notes / implementation ideas

No response

borgmatic version

borgmatic --version 2.1.2

borgmatic installation method

emerge

Borg version

borg --version borg 1.4.3

Python version

python3 --version Python 3.13.12

Database version (if applicable)

No DB.

Operating system and version

cat /etc/os-release NAME='Gentoo' ID='gentoo' PRETTY_NAME='Gentoo Linux' VERSION='2.18' VERSION_ID='2.18' HOME_URL='https://www.gentoo.org/' SUPPORT_URL='https://www.gentoo.org/support/' BUG_REPORT_URL='https://bugs.gentoo.org/' ANSI_COLOR='1;32'

### What I'm trying to do and why I'm trying to figure out why my backups are failing. The natural course of action here in my mind is to run the command with the `--verbose` flag. Instead I get a multi page scroll of options the command takes. This is not helpful. ### Steps to reproduce Run `borgmatic --verbose` When in this state even just running `borgmatic` returns nothing and an exit code of 0. ### Actual behavior borgmatic --verbose usage: borgmatic [-h] [-c CONFIG_PATHS] [-n] [--override OPTION.SUBOPTION=VALUE] [--no-environment-interpolation] [--bash-completion] [--fish-completion] [--version] [--after-actions[0] AFTER_ACTIONS[0]] [--after-actions AFTER_ACTIONS] [--after-backup[0] AFTER_BACKUP[0]] [--after-backup AFTER_BACKUP] [--after-check[0] AFTER_CHECK[0]] [--after-check AFTER_CHECK] [--after-compact[0] AFTER_COMPACT[0]] [--after-compact AFTER_COMPACT] [--after-everything[0] AFTER_EVERYTHING[0]] [--after-everything AFTER_EVERYTHING] [--after-extract[0] AFTER_EXTRACT[0]] [--after-extract AFTER_EXTRACT] [--after-prune[0] AFTER_PRUNE[0]] [--after-prune AFTER_PRUNE] [--apprise.fail.body BODY] [--apprise.fail.title TITLE] [--apprise.finish.body BODY] [--apprise.finish.title TITLE] [--apprise.log.body BODY] [--apprise.log.title TITLE] [--apprise.logs-size-limit LOGS_SIZE_LIMIT] [--apprise.send-logs] [--apprise.no-send-logs] [--apprise.services[0].label LABEL] [--apprise.services[0].url URL] [--apprise.services SERVICES] [--apprise.start.body BODY] [--apprise.start.title TITLE] [--apprise.states[0] STATES[0]] [--apprise.states STATES] [--archive-name-format ARCHIVE_NAME_FORMAT] [--atime] [--no-atime] [--before-actions[0] BEFORE_ACTIONS[0]] [--before-actions BEFORE_ACTIONS] [--before-backup[0] BEFORE_BACKUP[0]] [--before-backup BEFORE_BACKUP] [--before-check[0] BEFORE_CHECK[0]] [--before-check BEFORE_CHECK] [--before-compact[0] BEFORE_COMPACT[0]] [--before-compact BEFORE_COMPACT] [--before-everything[0] BEFORE_EVERYTHING[0]] [--before-everything BEFORE_EVERYTHING] [--before-extract[0] BEFORE_EXTRACT[0]] [--before-extract BEFORE_EXTRACT] [--before-prune[0] BEFORE_PRUNE[0]] [--before-prune BEFORE_PRUNE] [--birthtime] [--no-birthtime] [--bootstrap.store-config-files] [--bootstrap.no-store-config-files] [--borg-base-directory BORG_BASE_DIRECTORY] [--borg-cache-directory BORG_CACHE_DIRECTORY] [--borg-config-directory BORG_CONFIG_DIRECTORY] [--borg-exit-codes[0].code CODE] [--borg-exit-codes[0].treat-as TREAT_AS] [--borg-exit-codes BORG_EXIT_CODES] [--borg-files-cache-ttl BORG_FILES_CACHE_TTL] [--borg-key-file BORG_KEY_FILE] [--borg-keys-directory BORG_KEYS_DIRECTORY] [--borg-security-directory BORG_SECURITY_DIRECTORY] [--borgmatic-source-directory BORGMATIC_SOURCE_DIRECTORY] [--btrfs.btrfs-command BTRFS_COMMAND] [--btrfs.findmnt-command FINDMNT_COMMAND] [--check-i-know-what-i-am-doing] [--no-check-i-know-what-i-am-doing] [--check-last CHECK_LAST] [--check-repositories[0] CHECK_REPOSITORIES[0]] [--check-repositories CHECK_REPOSITORIES] [--checkpoint-interval CHECKPOINT_INTERVAL] [--checkpoint-volume CHECKPOINT_VOLUME] [--checks[0].frequency FREQUENCY] [--checks[0].count-tolerance-percentage COUNT_TOLERANCE_PERCENTAGE] [--checks[0].name NAME] [--checks[0].max-duration MAX_DURATION] [--checks[0].data-sample-percentage DATA_SAMPLE_PERCENTAGE] [--checks[0].only-run-on[0] ONLY_RUN_ON[0]] [--checks[0].only-run-on ONLY_RUN_ON] [--checks[0].data-tolerance-percentage DATA_TOLERANCE_PERCENTAGE] [--checks[0].xxh64sum-command XXH64SUM_COMMAND] [--checks CHECKS] [--chunker-params CHUNKER_PARAMS] [--color] [--no-color] [--commands[0].before BEFORE] [--commands[0].after AFTER] [--commands[0].run[0] RUN[0]] [--commands[0].run RUN] [--commands[0].when[0] WHEN[0]] [--commands[0].when WHEN] [--commands[0].states[0] STATES[0]] [--commands[0].states STATES] [--commands COMMANDS] [--compact-threshold COMPACT_THRESHOLD] [--compression COMPRESSION] [--constants CONSTANTS] [--container.secrets-directory SECRETS_DIRECTORY] [--cronhub.ping-url PING_URL] [--cronitor.ping-url PING_URL] [--ctime] [--no-ctime] [--debug-passphrase] [--no-debug-passphrase] [--default-actions] [--no-default-actions] [--display-passphrase] [--no-display-passphrase] [--encryption-passcommand ENCRYPTION_PASSCOMMAND] [--encryption-passphrase ENCRYPTION_PASSPHRASE] [--exclude-caches] [--no-exclude-caches] [--exclude-from[0] EXCLUDE_FROM[0]] [--exclude-from EXCLUDE_FROM] [--exclude-if-present[0] EXCLUDE_IF_PRESENT[0]] [--exclude-if-present EXCLUDE_IF_PRESENT] [--exclude-nodump] [--no-exclude-nodump] [--exclude-patterns[0] EXCLUDE_PATTERNS[0]] [--exclude-patterns EXCLUDE_PATTERNS] [--extra-borg-options.break-lock BREAK_LOCK] [--extra-borg-options.check CHECK] [--extra-borg-options.compact COMPACT] [--extra-borg-options.create CREATE] [--extra-borg-options.delete DELETE] [--extra-borg-options.export-tar EXPORT_TAR] [--extra-borg-options.extract EXTRACT] [--extra-borg-options.info INFO] [--extra-borg-options.init INIT] [--extra-borg-options.key-change-passphrase KEY_CHANGE_PASSPHRASE] [--extra-borg-options.key-export KEY_EXPORT] [--extra-borg-options.key-import KEY_IMPORT] [--extra-borg-options.list LIST] [--extra-borg-options.mount MOUNT] [--extra-borg-options.prune PRUNE] [--extra-borg-options.recreate RECREATE] [--extra-borg-options.rename RENAME] [--extra-borg-options.repo-create REPO_CREATE] [--extra-borg-options.repo-delete REPO_DELETE] [--extra-borg-options.repo-info REPO_INFO] [--extra-borg-options.repo-list REPO_LIST] [--extra-borg-options.transfer TRANSFER] [--extra-borg-options.umount UMOUNT] [--files-cache FILES_CACHE] [--flags] [--no-flags] [--healthchecks.create-slug] [--healthchecks.no-create-slug] [--healthchecks.ping-body-limit PING_BODY_LIMIT] [--healthchecks.ping-url PING_URL] [--healthchecks.send-logs] [--healthchecks.no-send-logs] [--healthchecks.states[0] STATES[0]] [--healthchecks.states STATES] [--healthchecks.verify-tls] [--healthchecks.no-verify-tls] [--keep-13weekly KEEP_13WEEKLY] [--keep-3monthly KEEP_3MONTHLY] [--keep-daily KEEP_DAILY] [--keep-exclude-tags] [--no-keep-exclude-tags] [--keep-hourly KEEP_HOURLY] [--keep-minutely KEEP_MINUTELY] [--keep-monthly KEEP_MONTHLY] [--keep-secondly KEEP_SECONDLY] [--keep-weekly KEEP_WEEKLY] [--keep-within KEEP_WITHIN] [--keep-yearly KEEP_YEARLY] [--keepassxc.ask-for-password] [--keepassxc.no-ask-for-password] [--keepassxc.keepassxc-cli-command KEEPASSXC_CLI_COMMAND] [--keepassxc.key-file KEY_FILE] [--keepassxc.yubikey YUBIKEY] [--local-path LOCAL_PATH] [--lock-wait LOCK_WAIT] [--log-file LOG_FILE] [--log-file-format LOG_FILE_FORMAT] [--log-file-verbosity LOG_FILE_VERBOSITY] [--log-json] [--no-log-json] [--loki.labels LABELS] [--loki.send-logs] [--loki.no-send-logs] [--loki.url URL] [--lvm.lsblk-command LSBLK_COMMAND] [--lvm.lvcreate-command LVCREATE_COMMAND] [--lvm.lvremove-command LVREMOVE_COMMAND] [--lvm.lvs-command LVS_COMMAND] [--lvm.mount-command MOUNT_COMMAND] [--lvm.snapshot-size SNAPSHOT_SIZE] [--lvm.umount-command UMOUNT_COMMAND] [--mariadb-databases[0].add-drop-database] [--mariadb-databases[0].no-add-drop-database] [--mariadb-databases[0].container CONTAINER] [--mariadb-databases[0].format FORMAT] [--mariadb-databases[0].hostname HOSTNAME] [--mariadb-databases[0].label LABEL] [--mariadb-databases[0].list-options LIST_OPTIONS] [--mariadb-databases[0].mariadb-command MARIADB_COMMAND] [--mariadb-databases[0].mariadb-dump-command MARIADB_DUMP_COMMAND] [--mariadb-databases[0].name NAME] [--mariadb-databases[0].options OPTIONS] [--mariadb-databases[0].password PASSWORD] [--mariadb-databases[0].password-transport PASSWORD_TRANSPORT] [--mariadb-databases[0].port PORT] [--mariadb-databases[0].restore-container RESTORE_CONTAINER] [--mariadb-databases[0].restore-hostname RESTORE_HOSTNAME] [--mariadb-databases[0].restore-options RESTORE_OPTIONS] [--mariadb-databases[0].restore-password RESTORE_PASSWORD] [--mariadb-databases[0].restore-port RESTORE_PORT] [--mariadb-databases[0].restore-socket-path RESTORE_SOCKET_PATH] [--mariadb-databases[0].restore-tls] [--mariadb-databases[0].no-restore-tls] [--mariadb-databases[0].restore-username RESTORE_USERNAME] [--mariadb-databases[0].skip-names[0] SKIP_NAMES[0]] [--mariadb-databases[0].skip-names SKIP_NAMES] [--mariadb-databases[0].socket-path SOCKET_PATH] [--mariadb-databases[0].tls] [--mariadb-databases[0].no-tls] [--mariadb-databases[0].username USERNAME] [--mariadb-databases MARIADB_DATABASES] [--mongodb-databases[0].authentication-database AUTHENTICATION_DATABASE] [--mongodb-databases[0].container CONTAINER] [--mongodb-databases[0].format FORMAT] [--mongodb-databases[0].hostname HOSTNAME] [--mongodb-databases[0].label LABEL] [--mongodb-databases[0].mongodump-command MONGODUMP_COMMAND] [--mongodb-databases[0].mongorestore-command MONGORESTORE_COMMAND] [--mongodb-databases[0].name NAME] [--mongodb-databases[0].options OPTIONS] [--mongodb-databases[0].password PASSWORD] [--mongodb-databases[0].port PORT] [--mongodb-databases[0].restore-container RESTORE_CONTAINER] [--mongodb-databases[0].restore-hostname RESTORE_HOSTNAME] [--mongodb-databases[0].restore-options RESTORE_OPTIONS] [--mongodb-databases[0].restore-password RESTORE_PASSWORD] [--mongodb-databases[0].restore-port RESTORE_PORT] [--mongodb-databases[0].restore-username RESTORE_USERNAME] [--mongodb-databases[0].username USERNAME] [--mongodb-databases MONGODB_DATABASES] [--monitoring-verbosity MONITORING_VERBOSITY] [--mysql-databases[0].add-drop-database] [--mysql-databases[0].no-add-drop-database] [--mysql-databases[0].container CONTAINER] [--mysql-databases[0].format FORMAT] [--mysql-databases[0].hostname HOSTNAME] [--mysql-databases[0].label LABEL] [--mysql-databases[0].list-options LIST_OPTIONS] [--mysql-databases[0].mysql-command MYSQL_COMMAND] [--mysql-databases[0].mysql-dump-command MYSQL_DUMP_COMMAND] [--mysql-databases[0].name NAME] [--mysql-databases[0].options OPTIONS] [--mysql-databases[0].password PASSWORD] [--mysql-databases[0].password-transport PASSWORD_TRANSPORT] [--mysql-databases[0].port PORT] [--mysql-databases[0].restore-container RESTORE_CONTAINER] [--mysql-databases[0].restore-hostname RESTORE_HOSTNAME] [--mysql-databases[0].restore-options RESTORE_OPTIONS] [--mysql-databases[0].restore-password RESTORE_PASSWORD] [--mysql-databases[0].restore-port RESTORE_PORT] [--mysql-databases[0].restore-socket-path RESTORE_SOCKET_PATH] [--mysql-databases[0].restore-tls] [--mysql-databases[0].no-restore-tls] [--mysql-databases[0].restore-username RESTORE_USERNAME] [--mysql-databases[0].skip-names[0] SKIP_NAMES[0]] [--mysql-databases[0].skip-names SKIP_NAMES] [--mysql-databases[0].socket-path SOCKET_PATH] [--mysql-databases[0].tls] [--mysql-databases[0].no-tls] [--mysql-databases[0].username USERNAME] [--mysql-databases MYSQL_DATABASES] [--ntfy.access-token ACCESS_TOKEN] [--ntfy.fail.message MESSAGE] [--ntfy.fail.priority PRIORITY] [--ntfy.fail.tags TAGS] [--ntfy.fail.title TITLE] [--ntfy.finish.message MESSAGE] [--ntfy.finish.priority PRIORITY] [--ntfy.finish.tags TAGS] [--ntfy.finish.title TITLE] [--ntfy.password PASSWORD] [--ntfy.server SERVER] [--ntfy.start.message MESSAGE] [--ntfy.start.priority PRIORITY] [--ntfy.start.tags TAGS] [--ntfy.start.title TITLE] [--ntfy.states[0] STATES[0]] [--ntfy.states STATES] [--ntfy.topic TOPIC] [--ntfy.username USERNAME] [--numeric-ids] [--no-numeric-ids] [--on-error[0] ON_ERROR[0]] [--on-error ON_ERROR] [--one-file-system] [--no-one-file-system] [--pagerduty.integration-key INTEGRATION_KEY] [--pagerduty.send-logs] [--pagerduty.no-send-logs] [--patterns[0] PATTERNS[0]] [--patterns PATTERNS] [--patterns-from[0] PATTERNS_FROM[0]] [--patterns-from PATTERNS_FROM] [--postgresql-databases[0].analyze-options ANALYZE_OPTIONS] [--postgresql-databases[0].compression COMPRESSION] [--postgresql-databases[0].container CONTAINER] [--postgresql-databases[0].format FORMAT] [--postgresql-databases[0].hostname HOSTNAME] [--postgresql-databases[0].label LABEL] [--postgresql-databases[0].list-options LIST_OPTIONS] [--postgresql-databases[0].name NAME] [--postgresql-databases[0].no-owner] [--postgresql-databases[0].owner] [--postgresql-databases[0].options OPTIONS] [--postgresql-databases[0].password PASSWORD] [--postgresql-databases[0].pg-dump-command PG_DUMP_COMMAND] [--postgresql-databases[0].pg-restore-command PG_RESTORE_COMMAND] [--postgresql-databases[0].port PORT] [--postgresql-databases[0].psql-command PSQL_COMMAND] [--postgresql-databases[0].restore-container RESTORE_CONTAINER] [--postgresql-databases[0].restore-hostname RESTORE_HOSTNAME] [--postgresql-databases[0].restore-options RESTORE_OPTIONS] [--postgresql-databases[0].restore-password RESTORE_PASSWORD] [--postgresql-databases[0].restore-port RESTORE_PORT] [--postgresql-databases[0].restore-username RESTORE_USERNAME] [--postgresql-databases[0].ssl-cert SSL_CERT] [--postgresql-databases[0].ssl-crl SSL_CRL] [--postgresql-databases[0].ssl-key SSL_KEY] [--postgresql-databases[0].ssl-mode SSL_MODE] [--postgresql-databases[0].ssl-root-cert SSL_ROOT_CERT] [--postgresql-databases[0].username USERNAME] [--postgresql-databases POSTGRESQL_DATABASES] [--prefix PREFIX] [--pushover.fail.device DEVICE] [--pushover.fail.expire EXPIRE] [--pushover.fail.html] [--pushover.fail.no-html] [--pushover.fail.message MESSAGE] [--pushover.fail.priority PRIORITY] [--pushover.fail.retry RETRY] [--pushover.fail.sound SOUND] [--pushover.fail.title TITLE] [--pushover.fail.ttl TTL] [--pushover.fail.url URL] [--pushover.fail.url-title URL_TITLE] [--pushover.finish.device DEVICE] [--pushover.finish.expire EXPIRE] [--pushover.finish.html] [--pushover.finish.no-html] [--pushover.finish.message MESSAGE] [--pushover.finish.priority PRIORITY] [--pushover.finish.retry RETRY] [--pushover.finish.sound SOUND] [--pushover.finish.title TITLE] [--pushover.finish.ttl TTL] [--pushover.finish.url URL] [--pushover.finish.url-title URL_TITLE] [--pushover.start.device DEVICE] [--pushover.start.expire EXPIRE] [--pushover.start.html] [--pushover.start.no-html] [--pushover.start.message MESSAGE] [--pushover.start.priority PRIORITY] [--pushover.start.retry RETRY] [--pushover.start.sound SOUND] [--pushover.start.title TITLE] [--pushover.start.ttl TTL] [--pushover.start.url URL] [--pushover.start.url-title URL_TITLE] [--pushover.states[0] STATES[0]] [--pushover.states STATES] [--pushover.token TOKEN] [--pushover.user USER] [--read-special] [--no-read-special] [--recompress RECOMPRESS] [--relocated-repo-access-is-ok] [--no-relocated-repo-access-is-ok] [--remote-path REMOTE_PATH] [--repositories[0].append-only] [--repositories[0].no-append-only] [--repositories[0].encryption ENCRYPTION] [--repositories[0].label LABEL] [--repositories[0].make-parent-directories] [--repositories[0].no-make-parent-directories] [--repositories[0].path PATH] [--repositories[0].storage-quota STORAGE_QUOTA] [--repositories REPOSITORIES] [--retries RETRIES] [--retry-wait RETRY_WAIT] [--sentry.data-source-name-url DATA_SOURCE_NAME_URL] [--sentry.environment ENVIRONMENT] [--sentry.monitor-slug MONITOR_SLUG] [--sentry.states[0] STATES[0]] [--sentry.states STATES] [--skip-actions[0] SKIP_ACTIONS[0]] [--skip-actions SKIP_ACTIONS] [--source-directories[0] SOURCE_DIRECTORIES[0]] [--source-directories SOURCE_DIRECTORIES] [--source-directories-must-exist] [--no-source-directories-must-exist] [--sqlite-databases[0].label LABEL] [--sqlite-databases[0].name NAME] [--sqlite-databases[0].path PATH] [--sqlite-databases[0].restore-path RESTORE_PATH] [--sqlite-databases[0].sqlite-command SQLITE_COMMAND] [--sqlite-databases[0].sqlite-restore-command SQLITE_RESTORE_COMMAND] [--sqlite-databases SQLITE_DATABASES] [--ssh-command SSH_COMMAND] [--syslog-verbosity SYSLOG_VERBOSITY] [--systemd.encrypted-credentials-directory ENCRYPTED_CREDENTIALS_DIRECTORY] [--systemd.systemd-creds-command SYSTEMD_CREDS_COMMAND] [--temporary-directory TEMPORARY_DIRECTORY] [--umask UMASK] [--unknown-unencrypted-repo-access-is-ok] [--no-unknown-unencrypted-repo-access-is-ok] [--unsafe-skip-path-validation-before-create] [--no-unsafe-skip-path-validation-before-create] [--upload-buffer-size UPLOAD_BUFFER_SIZE] [--upload-rate-limit UPLOAD_RATE_LIMIT] [--uptime-kuma.push-url PUSH_URL] [--uptime-kuma.states[0] STATES[0]] [--uptime-kuma.states STATES] [--uptime-kuma.verify-tls] [--uptime-kuma.no-verify-tls] [--use-chunks-archive] [--no-use-chunks-archive] [--user-runtime-directory USER_RUNTIME_DIRECTORY] [--user-state-directory USER_STATE_DIRECTORY] [-v VERBOSITY] [--working-directory WORKING_DIRECTORY] [--zabbix.api-key API_KEY] [--zabbix.fail.value VALUE] [--zabbix.finish.value VALUE] [--zabbix.host HOST] [--zabbix.itemid ITEMID] [--zabbix.key KEY] [--zabbix.password PASSWORD] [--zabbix.server SERVER] [--zabbix.start.value VALUE] [--zabbix.states[0] STATES[0]] [--zabbix.states STATES] [--zabbix.username USERNAME] [--zfs.mount-command MOUNT_COMMAND] [--zfs.umount-command UMOUNT_COMMAND] [--zfs.zfs-command ZFS_COMMAND] ... Unrecognized argument: --verbose Need some help? https://torsion.org/borgmatic/#issues ### Expected behavior I would expect it to attempt a backup job and then fail and give me some diagnostic information I could act upon. The spew I get from the program is unhelpful and overwhelming. ### Other notes / implementation ideas _No response_ ### borgmatic version borgmatic --version 2.1.2 ### borgmatic installation method emerge ### Borg version borg --version borg 1.4.3 ### Python version python3 --version Python 3.13.12 ### Database version (if applicable) No DB. ### Operating system and version cat /etc/os-release NAME='Gentoo' ID='gentoo' PRETTY_NAME='Gentoo Linux' VERSION='2.18' VERSION_ID='2.18' HOME_URL='https://www.gentoo.org/' SUPPORT_URL='https://www.gentoo.org/support/' BUG_REPORT_URL='https://bugs.gentoo.org/' ANSI_COLOR='1;32'

gosseljl changed title from ~~borgmatic --verbose is useless.~~ to borgmatic --verbose doesn't work as one would expect.

2026-03-02 04:01:35 +00:00

witten commented

2026-03-02 06:46:07 +00:00

Owner

--verbose is no a supported flag for borgmatic, and so it's erroring with an "Unrecognized argument" error (see the bottom of the output). I'm guessing that what you're looking for is instead --verbosity 2. Please give that a shot and let me know if it works better.

`--verbose` is no a supported flag for borgmatic, and so it's erroring with an "Unrecognized argument" error (see the bottom of the output). I'm guessing that what you're looking for is instead [`--verbosity 2`](https://torsion.org/borgmatic/reference/command-line/logging/). Please give that a shot and let me know if it works better.