Scroll to navigation

borg-umount(1) borg backup tool borg-umount(1)

Name

borg-umount - Unmounts the FUSE filesystem.

SYNOPSIS

borg [common options] umount [options] MOUNTPOINT

DESCRIPTION

This command unmounts a FUSE filesystem that was mounted with borg mount.

This is a convenience wrapper that just calls the platform-specific shell command - usually this is either umount or fusermount -u.

OPTIONS

See borg-common(1) for common options of Borg commands.

arguments

mountpoint of the filesystem to unmount

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 pyinstaller-binary).


SEE ALSO

borg-common(1), borg-mount(1)

Author

The Borg Collective

2026-09-26