MOUNT.EROFS(8)

💖 MOUNT.EROFS — the manual page, but make it slay 💖

okay bestie, sit down, hydrate, because we're about to talk about mount.erofs, a System Manager's Manual entry, section 8. she's part of erofs-utils and she's lowkey the most put-together tool in the whole friend group. 🎀

---

✨ NAME ✨

mount.erofs — manage EROFS filesystem

---

🌸 SYNOPSIS 🌸

mount.erofs [OPTIONS] SOURCE MOUNTPOINT
mount.erofs -u TARGET
mount.erofs --reattach TARGET

---

🦋 DESCRIPTION 🦋

So. EROFS is an enhanced lightweight read-only filesystem with modern designs for scenarios that need high-performance read-only requirements. she's the girl who shows up, does the job, and doesn't need a whole personality crisis about it. 💅

mount.erofs is what you use to mount an EROFS filesystem from SOURCE (which can be an image file or a block device, she doesn't judge) onto a MOUNTPOINT. and the way that she supports multiple backends?? direct kernel mount, FUSE-based mount, and NBD (Network Block Device) for remote sources like OCI images. versatility, periodt. ✨

---

👑 OPTIONS 👑

• -h, --help — display help message and exit. bestie just tells you what's up.
• -V, --version — display version information and exit. her little introduction moment.
• -o options — comma-separated list of mount options. see MOUNT OPTIONS below, i gotchu. 💖
• -t type[.subtype] — specify the filesystem type and optional subtype. the type should be erofs. available subtypes are:
  • fuse — use FUSE-based mount via erofsfuse.
  • local — force direct kernel mount (default if available).
  • nbd — use NBD backend for remote sources (e.g., OCI images).
• -u — unmount the filesystem at the specified target.
• --reattach — reattach to an existing NBD device and restart the NBD service.

---

🌈 MOUNT OPTIONS 🌈

Standard mount options, the classics, the icons:

• ro — mount the filesystem read-only (default).
• rw — mount the filesystem read-write (not supported for EROFS).
• nosuid — do not honor set-user-ID and set-group-ID bits.
• suid — honor set-user-ID and set-group-ID bits (default).
• nodev — do not interpret character or block special devices.
• dev — interpret character or block special devices (default).
• noexec — do not allow direct execution of any binaries.
• exec — allow execution of binaries (default).
• noatime — do not update inode access times.
• atime — update inode access times (default).
• nodiratime — do not update directory inode access times.
• diratime — update directory inode access times (default).
• relatime — update inode access times relative to modify or change time.
• norelatime — do not use relative atime updates.

---

🍓 OCI-SPECIFIC OPTIONS 🍓

the following OCI-specific options are available (yes queen, containers too):

• oci.blob=digest — specify the OCI blob digest to mount. the digest should be in the format sha256:..... cannot be used together with oci.layer. pick a lane bestie 💀
• oci.layer=index — specify the OCI layer index to mount (0-based). cannot be used together with oci.blob. same energy, opposite direction.
• oci.platform=platform — specify the target platform (default: linux/amd64).
• oci.username=username — username for OCI registry authentication.
• oci.password=password — password for OCI registry authentication.
• oci.tarindex=path — path to a tarball index file for hybrid tar+OCI mode.
• oci.zinfo=path — path to a gzip zinfo file for random access to gzip-compressed tar layers.
• oci.insecure — use HTTP instead of HTTPS to access the image registry. 🙈

---

💜 NOTES 💜

• EROFS filesystems are read-only by nature. the rw option will be ignored. she said no and she meant it. 🫶
• When mounting OCI images via NBD, the mount process creates a background daemon to serve the NBD device. the daemon will automatically clean up when the filesystem is unmounted. self-sufficient queen, no notes. 👑
• The --reattach option is useful for recovering NBD mounts after a system crash or when the NBD daemon was terminated unexpectedly. she's giving resilience, she's giving comeback era. ✨
• Kernel direct mount is used when mounting a regular file without specifying a backend type. if file-based mounts is unsupported, loop devices will be set up automatically.

fr fr, read these notes before you come crying to the group chat. 😭

---

🧚 SEE ALSO 🧚

mkfs.erofs(1), erofsfuse(1), dump.erofs(1), fsck.erofs(1), mount(8), umount(8)

---

⭐ AVAILABILITY ⭐

mount.erofs is part of erofs-utils.

---

and that's the whole page, bestie!! 💖 mount.erofs, section 8 of the System Manager's Manual, shipped as part of erofs-utils — go mount something read-only and be iconic about it. 🎀✨🦋