---
name: "borgmatic"
section: "1"
platform: "linux"
package: "borgmatic"
version: "1.9.14-0.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/borgmatic"
---

# borgmatic(1)

backups manager for borgbackup

## NAME

borgmatic - backups manager for borgbackup

## SYNOPSIS

borgmatic \[*options*\]

## DESCRIPTION

A simple wrapper script for the Borg backup software that creates and prunes backups. If none of the action options are given, then borgmatic defaults to: prune, create, and check archives.

## OPTIONS

### optional arguments

- \-h, --help

  Show this help message and exit

### global arguments

- \-c *\[CONFIG\_PATHS \[CONFIG\_PATHS ...\]\]*, --config *\[CONFIG\_PATHS \[CONFIG\_PATHS ...\]\]*

  Configuration filenames or directories, defaults to: /etc/borgmatic/config.yaml /etc/borgmatic.d /root/.config/borgmatic/config.yaml

- \--excludes *EXCLUDES\_FILENAME*

  Deprecated in favor of exclude\_patterns within configuration

- \-n, --dry-run

  Go through the motions, but do not actually write to any repositories

- \-nc, --no-color

  Disable colored output

- \-v *{0,1,2}*, --verbosity *{0,1,2}*

  Display verbose progress to the console (from none to lots: 0, 1, or 2)

- \--syslog-verbosity *{0,1,2}*

  Display verbose progress to syslog (from none to lots: 0, 1, or 2). Ignored when console is interactive

- \--version

  Display installed version number of borgmatic and exit

### actions

Specify zero or more actions. Defaults to prune, create, and check. Use –help with action for details:

- init (*--init, -I*)

  Initialize an empty Borg repository

- prune (*--prune, -p*)

  Prune archives according to the retention policy

- create (*--create, -C*)

  Create archives (actually perform backups)

- check (*--check, -k*)

  Check archives for consistency

- extract (*--extract, -x*)

  Extract a named archive to the current directory

- list (*--list, -l*)

  List archives

- info (*--info, -i*)

  Display summary information on archives

## SEE ALSO

The borgmatic source code and all documentation may be downloaded from⟨https://github.com/witten/borgmatic⟩\\c

## AUTHORS

Dan Helfman ⟨witten@torsion.org⟩\\c.