# Install fuse-overlayfs with Homebrew, apk, apt, dnf, Nix, pacman, zypper FUSE implementation for overlayfs. Version 1.17 via Homebrew; verified 2026-06-09. ## Install ```sh sudo av install brew:fuse-overlayfs ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install fuse-overlayfs ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add fuse-overlayfs ``` Evidence: Alpine Linux edge package indexes: fuse-overlayfs from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install fuse-overlayfs ``` Evidence: Debian stable package indexes: fuse-overlayfs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install fuse-overlayfs ``` Evidence: Fedora Rawhide package metadata: fuse-overlayfs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#fuse-overlayfs ``` Evidence: nixpkgs package indexes: pkgs/by-name/fu/fuse-overlayfs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S fuse-overlayfs ``` Evidence: Arch Linux sync databases: fuse-overlayfs from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install fuse-overlayfs ``` Evidence: openSUSE Tumbleweed package metadata: fuse-overlayfs from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:fuse-overlayfs - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.17 - **Source summary:** FUSE implementation for overlayfs - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-2.0-or-later - **Source archive:** - **Last updated:** 2026-06-09T12:53:39Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - fuse-overlayfs (cli) - fuse-overlayfs (alias) ## Dependencies - libfuse ## Build dependencies - autoconf - automake - pkgconf ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.17 - Package-manager updated: 2026-06-09 - Local data: ok - Upstream repository: https://github.com/containers/fuse-overlayfs - Upstream latest detected: v1.17 (current) ## Project history and usage fuse-overlayfs is a FUSE implementation of overlay-style filesystems for rootless containers. The official README describes it as an implementation of overlay and shiftfs in FUSE, with command-line options for lower, upper, work, merged, UID, and GID mappings. ### Project history The project lives under the containers organization and is written in Rust. Its README documents libfuse 3.2.1 or newer as a requirement and notes that use from a user namespace, such as rootless Podman, requires a Linux kernel at least 4.18.0. ### Adoption history fuse-overlayfs became part of the rootless-container storage story because many kernels prevent unprivileged users from mounting kernel overlay filesystems. The containers/storage manual documents `mount_program = "/usr/bin/fuse-overlayfs"` as the custom mount helper used when rootless storage cannot use kernel defaults. The same containers/storage documentation names fuse-overlayfs in its `SEE ALSO` section and in examples involving permission masks, showing that it is treated as a normal component of the containers storage stack rather than a standalone experiment. ### How it is used Users can run fuse-overlayfs directly by passing overlay-style mount options such as `lowerdir`, `upperdir`, `workdir`, and a merged directory. Container engines more often invoke it indirectly through containers/storage configuration as a `mount_program`. The project also distributes pre-built static binaries for multiple architectures through GitHub Releases, which makes it practical on container hosts where the binary is needed before normal package-manager integration is available. ### Why package nerds care The package matters because it made overlay-style copy-on-write storage usable for rootless container workflows before all target kernels could provide equivalent unprivileged overlay support. It is a small package with outsized influence in Podman and OCI tooling because storage-driver details determine whether rootless containers feel native or second-class. ### Timeline - 2017: containers/storage documentation originates the shared storage configuration manual. - v1.0.0: fuse-overlayfs reaches a stable tagged release line. - Current README: project documents rootless Podman and Linux kernel requirements for user-namespace operation. ### Related projects - fuse-overlayfs is closely related to containers/storage, which documents the `mount_program` setting. - It is also related to Podman rootless operation, which relies on the containers configuration stack for user storage. ### Sources - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** fuse-overlayfs - **Version Scheme:** 0 - **Revision:** 0 - **Requirements:** linux - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - fuse-overlayfs - 1.14-1+b1: normalized package name match | Debian stable package indexes: fuse-overlayfs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | implementation of overlay+shiftfs in FUSE for rootless containers | https://github.com/containers/fuse-overlayfs - Nix - fuse-overlayfs: normalized package name match | nixpkgs package indexes: pkgs/by-name/fu/fuse-overlayfs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - fuse-overlayfs - 1.13-1: normalized package name match | Ubuntu 24.04 LTS package indexes: fuse-overlayfs from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | implementation of overlay+shiftfs in FUSE for rootless containers | https://github.com/containers/fuse-overlayfs - apk - fuse-overlayfs - 1.16-r0: normalized package name match | Alpine Linux edge package indexes: fuse-overlayfs from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | FUSE implementation for overlayfs | https://github.com/containers/fuse-overlayfs - apk - fuse-overlayfs-doc - 1.16-r0: normalized package name match | Alpine Linux edge package indexes: fuse-overlayfs-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | FUSE implementation for overlayfs (documentation) | https://github.com/containers/fuse-overlayfs - dnf - fuse-overlayfs - 1.16-2.fc44: normalized package name match | Fedora Rawhide package metadata: fuse-overlayfs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | FUSE overlay+shiftfs implementation for rootless containers | https://github.com/containers/fuse-overlayfs - pacman - fuse-overlayfs - 1.16-1: normalized package name match | Arch Linux sync databases: fuse-overlayfs from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | FUSE implementation of overlayfs | https://github.com/containers/fuse-overlayfs - zypper - fuse-overlayfs - 1.16-1.4: normalized package name match | openSUSE Tumbleweed package metadata: fuse-overlayfs from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | FUSE implementation for overlayfs | https://github.com/containers/fuse-overlayfs ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [libfuse](https://www.automicvault.com/pkg/brew/libfuse/) - Runtime dependency declared by Homebrew. - [autoconf](https://www.automicvault.com/pkg/brew/autoconf/) - Build dependency declared by Homebrew. - [automake](https://www.automicvault.com/pkg/brew/automake/) - Build dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [erofs-utils](https://www.automicvault.com/pkg/brew/erofs-utils/) - Shares av.db curated category or tags: cli, filesystems, fuse, linux, system. - [btfs](https://www.automicvault.com/pkg/brew/btfs/) - Shares av.db curated category or tags: cli, filesystems, fuse, system. - [btrfs-progs](https://www.automicvault.com/pkg/brew/btrfs-progs/) - Shares av.db curated category or tags: cli, filesystems, linux, system. - [dwarfs](https://www.automicvault.com/pkg/brew/dwarfs/) - Shares av.db curated category or tags: cli, filesystems, fuse, system. - [dysk](https://www.automicvault.com/pkg/brew/dysk/) - Shares av.db curated category or tags: cli, filesystems, linux, system. - [e2fsprogs](https://www.automicvault.com/pkg/brew/e2fsprogs/) - Shares av.db curated category or tags: cli, filesystems, linux, system. - [ext4fuse](https://www.automicvault.com/pkg/brew/ext4fuse/) - Shares av.db curated category or tags: cli, filesystems, fuse, system. - [fuse-zip](https://www.automicvault.com/pkg/brew/fuse-zip/) - Shares av.db curated category or tags: cli, filesystems, fuse, system. - [ratarmount](https://www.automicvault.com/pkg/brew/ratarmount/) - Local package facts share a topical domain. Shared terms: cli, filesystems, fuse, libfuse, system. ## Combined YAML source View the package source record on GitHub. [combined/fuse-overlayfs.yml](https://github.com/automic-vault/db/blob/main/combined/fuse-overlayfs.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph