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

# [NAME](#NAME)

mount.erofs - manage EROFS filesystem

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

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.

# [OPTIONS](#OPTIONS)

[**-h, --help**](#h,)

Display help message and exit.

[**-V, --version**](#V,)

Display version information and exit.

[**-o options**](#o)

Comma-separated list of mount options. See **MOUNT OPTIONS** below.

[**-t type\[.subtype\]**](#t)

Specify the filesystem type and optional subtype. The type should be **erofs**. Available subtypes are:

[**fuse**](#fuse)

Use FUSE-based mount via **erofsfuse**.

[**local**](#local)

Force direct kernel mount (default if available).

[**nbd**](#nbd)

Use NBD backend for remote sources (e.g., OCI images).

[**-u**](#u)

Unmount the filesystem at the specified target.

[**--reattach**](#reattach)

Reattach to an existing NBD device and restart the NBD service.

# [MOUNT OPTIONS](#MOUNT_OPTIONS)

Standard mount options:

[**ro**](#ro)

Mount the filesystem read-only (default).

[**rw**](#rw)

Mount the filesystem read-write (not supported for EROFS).

[**nosuid**](#nosuid)

Do not honor set-user-ID and set-group-ID bits.

[**suid**](#suid)

Honor set-user-ID and set-group-ID bits (default).

[**nodev**](#nodev)

Do not interpret character or block special devices.

[**dev**](#dev)

Interpret character or block special devices (default).

[**noexec**](#noexec)

Do not allow direct execution of any binaries.

[**exec**](#exec)

Allow execution of binaries (default).

[**noatime**](#noatime)

Do not update inode access times.

[**atime**](#atime)

Update inode access times (default).

[**nodiratime**](#nodiratime)

Do not update directory inode access times.

[**diratime**](#diratime)

Update directory inode access times (default).

[**relatime**](#relatime)

Update inode access times relative to modify or change time.

[**norelatime**](#norelatime)

Do not use relative atime updates.

# [OCI-SPECIFIC OPTIONS](#OCI-SPECIFIC_OPTIONS)

The following OCI-specific options are available:

[**oci.blob=digest**](#oci.blob=)

Specify the OCI blob digest to mount. The digest should be in the format **sha256:...**. Cannot be used together with **oci.layer**.

[**oci.layer=index**](#oci.layer=)

Specify the OCI layer index to mount (0-based). Cannot be used together with **oci.blob**.

[**oci.platform=platform**](#oci.platform=)

Specify the target platform (default: **linux/amd64**).

[**oci.username=username**](#oci.username=)

Username for OCI registry authentication.

[**oci.password=password**](#oci.password=)

Password for OCI registry authentication.

[**oci.tarindex=path**](#oci.tarindex=)

Path to a tarball index file for hybrid tar+OCI mode.

[**oci.zinfo=path**](#oci.zinfo=)

Path to a gzip zinfo file for random access to gzip-compressed tar layers.

[**oci.insecure**](#oci.insecure)

Use HTTP instead of HTTPS to access the image registry.

# [NOTES](#NOTES)

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

# [SEE ALSO](#SEE_ALSO)

[**mkfs.erofs**(1)](/man/os/erofs-utils/mkfs.erofs.1), [**erofsfuse**(1)](/man/os/erofs-utils/erofsfuse.1), [**dump.erofs**(1)](/man/os/erofs-utils/dump.erofs.1), [**fsck.erofs**(1)](/man/os/erofs-utils/fsck.erofs.1), [**mount**(8)](/man/os/erofs-utils/mount.8), [**umount**(8)](/man/os/erofs-utils/umount.8)

# [AVAILABILITY](#AVAILABILITY)

**mount.erofs** is part of erofs-utils.

---

Document: mount.erofs(8) from erofs-utils 1.9.4-r1 (Chainguard OS)
Source: https://kernel.googlesource.com/pub/scm/linux/kernel/git/xiang/erofs-utils.git