mirror of
https://github.com/borgbackup/borg.git
synced 2026-09-01 14:13:19 +02:00
abfec01736The sample listing still showed borg1-era content-hash suffixes (doc.cda00bc9.txt); the versions view names files with a sequential 5-digit version (doc.00001.txt). Sample regenerated from a real mount -o versions run. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
60 lines
2 KiB
ReStructuredText
60 lines
2 KiB
ReStructuredText
.. include:: mount.rst.inc
|
|
|
|
.. include:: umount.rst.inc
|
|
|
|
Examples
|
|
~~~~~~~~
|
|
|
|
::
|
|
|
|
# Mounting the repository shows all archives (here: two archives of the series
|
|
# "root", the short archive id is appended to make the directory names unique).
|
|
# Archives are loaded lazily, expect some delay when navigating to an archive
|
|
# for the first time.
|
|
$ borg mount /tmp/mymountpoint
|
|
$ ls /tmp/mymountpoint
|
|
root-1f7b3c2a root-9e4d0b58
|
|
$ borg umount /tmp/mymountpoint
|
|
|
|
# BORG_MOUNT_ARCHIVE_DIR_FORMAT names the archive directories differently,
|
|
# using the placeholders of "borg repo-list --format":
|
|
$ BORG_MOUNT_ARCHIVE_DIR_FORMAT='{name}-{time:%Y-%m-%d}' borg mount /tmp/mymountpoint
|
|
$ ls /tmp/mymountpoint
|
|
root-2016-02-14 root-2016-02-15
|
|
$ borg umount /tmp/mymountpoint
|
|
|
|
# The "versions view" merges all archives in the repository
|
|
# and provides a versioned view on files.
|
|
$ borg mount -o versions /tmp/mymountpoint
|
|
$ ls -l /tmp/mymountpoint/home/user/doc.txt/
|
|
total 47
|
|
-rw-r--r-- 1 user group 12167 Aug 28 23:14 doc.00001.txt
|
|
-rw-r--r-- 1 user group 11444 Aug 28 23:15 doc.00002.txt
|
|
$ borg umount /tmp/mymountpoint
|
|
|
|
# Archive filters are supported.
|
|
# These are especially handy for the "versions view",
|
|
# which does not support lazy processing of archives.
|
|
$ borg mount -o versions --match-archives 'sh:*-my-home' --last 10 /tmp/mymountpoint
|
|
|
|
# Exclusion options are supported.
|
|
# These can speed up mounting and lower memory needs significantly.
|
|
$ borg mount -r /path/to/repo /tmp/mymountpoint only/that/path
|
|
$ borg mount --exclude '...' /tmp/mymountpoint
|
|
|
|
|
|
borgfs
|
|
++++++
|
|
|
|
::
|
|
|
|
$ echo '/mnt/backup /tmp/myrepo fuse.borgfs defaults,noauto 0 0' >> /etc/fstab
|
|
$ mount /tmp/myrepo
|
|
$ ls /tmp/myrepo
|
|
root-2016-02-01 root-2016-02-15
|
|
|
|
.. Note::
|
|
|
|
``borgfs`` will be automatically provided if you used a distribution
|
|
package or ``pip`` to install Borg. Users of the standalone binary will have
|
|
to manually create a symlink (see :ref:`pyinstaller-binary`).
|