FUSE-OVERLAYFS(1)

NAME
fuse-overlayfs - overlay filesystem in userspace

SYNOPSIS
fuse-overlayfs [-o options] mountpoint

DESCRIPTION
fuse-overlayfs provides an overlay filesystem implemented as a FUSE (Filesystem in Userspace) mount. It allows stacking writable upper layers over read-only lower layers, the same semantic as the in-kernel overlayfs, but without requiring kernel support or root privileges.

This is the primary storage driver for rootless Podman containers on hosts that do not support user-namespace overlay mounts. It provides full POSIX semantics including whiteouts, opaque directories, and extended attributes for storage layers.

OPTIONS
Options are passed via the -o flag as a comma-separated list:

lowerdir=dir
    Read-only lower layer.

upperdir=dir
    Writable upper layer.

workdir=dir
    Working directory (must be on the same filesystem as upperdir).

SEE ALSO
podman(1), fuse(8), mount.fuse(8)

Upstream documentation: https://github.com/containers/fuse-overlayfs.