Borg

Borg backup

Links

• Homepage
• Borg FAQ
• support keyring for passphrase storage
• Borg on windows
• A borg script
• About upgrading to borg 2
• Someone did some benchmarking

Tools

• [ https://vorta.borgbase.com/ Vorta, a borg backup GUI for Linux and MacOS]

HOWTO

Rename repository

• On server: rename repository
• On client: change previous_location in ~/.cache/borg/*.config
• BORG_RELOCATED_REPO_ACCESS_IS_OK=yes

Extract with pattern

borg extract server:repo sh:path/to/files.*

Install using pip

apt-get install libssl-dev python3-cryptography liblz4-dev libzstd-dev libxxhash-dev libacl1-dev 
pip install borgbackup==1.2.0

Mount borg archive

borg mount

borg mount not available: no FUSE support, BORG_FUSE_IMPL=pyfuse3,llfuse

apt install python3-pyfuse3

FAQ

4 orphaned objects found!

A job for borg check

Enter passphrase for key

probably means the BORG_PASSPHRASE

Remote: Using a pure-python msgpack! This will result in lower performance

On CentOS: try installing python34-msgpack?

'user@borgserver' ?

Error messages

does not look like a Borg cache

It got corrupted somehow, try

borg delete --cache-only REPO

Connection closed by remote host. Is borg working on the server?

Usually ssh key problem of it means borg is not installed on the server

Failed to create/acquire the lock

Usually the 'timeout' bit is relevant. Just try again later. Does the backup or source happen to be pretty big?

BlockingIOError: [Errno 11] Resource temporarily unavailable

windows?

Corrupted segment reference count - corrupted index or hints

For some reason it might help to run

borg check --repository-only

Exception: FD exception occurred

Probably running borg on cygwin, could be ssh key issue. Try

BORG_RSH="ssh -vvv" borg ...

Also check your quotes

Cache, or information obtained from the security directory is newer than repository - this is either an attack or unsafe (multiple repos with same ID)

Something broke during a backup, try (re)moving ~/.config/borg/security/<id> and ~/.cache/borg/<id>.

Prune: Chunk ID missing from chunks index, corrupted chunks index - aborting transaction.

Try

borg check ( --repair )

If check finds no problem, delete cache:

mv ~/.cache/borg ~/.cache/borg_corrupted

ValueError: stats_against: key contained in self but not in master_index.

Try

borg check ( --repair )

The 'borgbackup==1.1.3' distribution was not found and is required by the application

Incomplete install?

Segment not found, but listed in compaction data

Try

borg check

and then perhaps

borg check --repair

Deduplicated size

For single archive: total size of unique chunks for this archive