borg-umount(1)

💅 borg-umount — bestie, we're UN-mounting 💅

okay so real quick, this is the manual for borg-umount, part of the borg backup tool. she's a little one, but she's important ✨

---

✨ NAME ✨

borg-umount — Unmounts the FUSE filesystem. that's it. that's the job. and she does it flawlessly 💖

---

🦋 SYNOPSIS 🦋

borg [common options] umount [options] MOUNTPOINT

---

🌸 DESCRIPTION 🌸

so here's the vibe: this command unmounts a FUSE filesystem that was mounted with borg mount. that's the whole point of her existence and she's lowkey iconic for it 🫶

she's a convenience wrapper — meaning she doesn't do the heavy lifting herself, she just calls the platform-specific shell command for you. usually that's either umount or fusermount -u. so she's basically your bestie who knows a guy 👑

---

👑 OPTIONS 👑

there's a whole world of common options — go check borg-common(1) for those, bestie. that's where the shared stuff lives.

🌈 arguments 🌈

• MOUNTPOINT — the mountpoint of the filesystem you wanna unmount. like, the directory. the spot. the place. she needs to know where 💅

---

🎀 EXAMPLES 🎀

okay, this part is long but it ATE, fr fr. watch:

# 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

see how every single one of those ends with a borg umount /tmp/mymountpoint? that's her. that's her moment. main character energy only 😌

🧚 borgfs 🧚

and there's also this whole borgfs thing, which is giving fstab realness:

$ 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).

so if you went the standalone binary route, no symlink magically appears, you gotta make it yourself. sorry bestie, them's the rules 💀

---

💜 SEE ALSO 💜

• borg-common(1)
• borg-mount(1)

---

🌟 Author 🌟

The Borg Collective — yeah, the whole collective. no single credit, they move as a unit. obsessed 💖

---

and that's the page! written for Borg, dated 2026-10-07, manual page borg-umount(1). go unmount something, you got this 🦋✨💅