No description
  • Rust 70.2%
  • Shell 27.8%
  • Roff 1.4%
  • Makefile 0.5%
  • C 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Giuseppe Scrivano 72c86e60eb
Merge pull request #464 from giuseppe/use-logging-crate
fuse-overlayfs: replace eprintln! with log crate macros
2026-05-29 13:44:07 +02:00
.github/workflows fuse-overlayfs: remove C implementation 2026-05-04 15:58:08 +02:00
src fuse-overlayfs: replace eprintln! with log crate macros 2026-05-29 12:19:58 +02:00
tests fuse-overlayfs: remove C implementation 2026-05-04 15:58:08 +02:00
.gitignore fuse-overlayfs: remove C implementation 2026-05-04 15:58:08 +02:00
AGENTS.md AGENTS.md: new file 2026-05-04 15:58:07 +02:00
Cargo.lock fuse-overlayfs: use rustix instead of nix 2026-05-07 22:35:22 +02:00
Cargo.toml fuse-overlayfs: use rustix instead of nix 2026-05-07 22:35:22 +02:00
CODE-OF-CONDUCT.md Add Code of Conduct 2020-02-08 17:24:56 -05:00
Containerfile.alpine fuse-overlayfs: remove C implementation 2026-05-04 15:58:08 +02:00
COPYING fuse-overlays: change license to GPLv2+ 2023-04-11 18:25:46 +02:00
fuse-overlayfs.1 man: regenerate 2026-01-17 13:49:10 +01:00
fuse-overlayfs.1.md man: uniformly apply bold attributes 2026-01-17 13:43:17 +01:00
Makefile fuse-overlayfs: remove C implementation 2026-05-04 15:58:08 +02:00
NEWS NEWS: tag 1.16 2025-11-05 11:28:52 +01:00
README.md fuse-overlayfs: remove C implementation 2026-05-04 15:58:08 +02:00
SECURITY.md Add Security Policy 2020-05-09 15:14:50 -04:00

fuse-overlayfs

An implementation of overlay+shiftfs in FUSE for rootless containers.

Usage:

$ fuse-overlayfs -o lowerdir=lowerdir/a:lowerdir/b,upperdir=up,workdir=workdir merged

Specify a different UID/GID mapping:

$ fuse-overlayfs -o uidmapping=0:10:100:100:10000:2000,gidmapping=0:10:100:100:10000:2000,lowerdir=lowerdir/a:lowerdir/b,upperdir=up,workdir=workdir merged

Requirements:

Your system needs libfuse >= v3.2.1.

  • On Fedora: dnf install fuse3-devel
  • On Ubuntu >= 19.04: apt install libfuse3-dev

Also, please note that, when using fuse-overlayfs from a user namespace (for example, when using rootless podman) a Linux Kernel >= v4.18.0 is required.

Building:

fuse-overlayfs is written in Rust. To build:

cargo build --release

The resulting binary is at target/release/fuse-overlayfs.

To install:

make install

Pre-built static binaries for multiple architectures (x86_64, aarch64, armv7l, s390x, ppc64le, riscv64) are available from the GitHub Releases page.