tldr/pages/common/borg.md

1007 B

borg

Deduplicating backup tool. Creates local or remote backups that are mountable as filesystems.

  • Initialise a (local) repository:

borg init {{/path/to/repo_directory}}

  • Backup a directory into the repository, creating an archive called "Monday":

borg create --progress {{/path/to/repo_directory}}::{{Monday}} {{/path/to/source_directory}}

  • List all archives in a repository:

borg list {{/path/to/repo_directory}}

  • Extract a specific directory from the "Monday" archive in a remote repository, excluding all *.ext files:

borg extract {{user}}@{{host}}:{{/path/to/repo_directory}}::{{Monday}} {{path/to/target_directory}} --exclude '{{*.ext}}'

  • Prune a repository by deleting all archives older than 7 days, listing changes:

borg prune --keep-within {{7d}} --list {{/path/to/repo_directory}}

  • Mount a repository as a FUSE filesystem:

borg mount {{/path/to/repo_directory}}::{{Monday}} {{/path/to/mountpoint}}

  • Display help on creating archives:

borg create --help