MOUNT.EROFS(8) System Manager's Manual MOUNT.EROFS(8)

mount.erofs - manage EROFS filesystem

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

EROFS is an enhanced lightweight read-only filesystem with modern designs for scenarios which need high-performance read-only requirements.

mount.erofs is used to mount an EROFS filesystem from SOURCE (which can be an image file or block device) to a MOUNTPOINT. It supports multiple backends including direct kernel mount, FUSE-based mount, and NBD (Network Block Device) for remote sources like OCI images.

Display help message and exit.
Display version information and exit.
Comma-separated list of mount options. See MOUNT OPTIONS below.
Specify the filesystem type and optional subtype. The type should be erofs. Available subtypes are:
Use FUSE-based mount via erofsfuse.
Force direct kernel mount (default if available).
Use NBD backend for remote sources (e.g., OCI images).
Unmount the filesystem at the specified target.
Reattach to an existing NBD device and restart the NBD service.

Standard mount options:

Mount the filesystem read-only (default).
Mount the filesystem read-write (not supported for EROFS).
Do not honor set-user-ID and set-group-ID bits.
Honor set-user-ID and set-group-ID bits (default).
Do not interpret character or block special devices.
Interpret character or block special devices (default).
Do not allow direct execution of any binaries.
Allow execution of binaries (default).
Do not update inode access times.
Update inode access times (default).
Do not update directory inode access times.
Update directory inode access times (default).
Update inode access times relative to modify or change time.
Do not use relative atime updates.

The following OCI-specific options are available:

Specify the OCI blob digest to mount. The digest should be in the format sha256:.... Cannot be used together with oci.layer.
Specify the OCI layer index to mount (0-based). Cannot be used together with oci.blob.
Specify the target platform (default: linux/amd64).
Username for OCI registry authentication.
Password for OCI registry authentication.
Path to a tarball index file for hybrid tar+OCI mode.
Path to a gzip zinfo file for random access to gzip-compressed tar layers.
Use HTTP instead of HTTPS to access the image registry.

  • EROFS filesystems are read-only by nature. The rw option will be ignored.
  • 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.
  • The --reattach option is useful for recovering NBD mounts after a system crash or when the NBD daemon was terminated unexpectedly.
  • 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.

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

mount.erofs is part of erofs-utils.