macOS
Homebrewverified · 100%
brew install fuse-overlayfsprovider-native install command
brew / rank 805
Install fuse-overlayfs with Homebrew
FUSE implementation for overlayfs. Version 1.17 via Homebrew; verified 2026-06-09.
install
Additional install commands
overview
Package summary
FUSE implementation for overlayfs
Project links
Commands and aliases
- fuse-overlayfs
history
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 posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
fuse-overlayfs | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version1.17
manager updated2026-06-09
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:fuse-overlayfs |
|---|---|
| Version | 1.17 |
| Package manager | Homebrew |
| Homepage | https://github.com/containers/fuse-overlayfs |
| Repository | https://github.com/containers/fuse-overlayfs |
| Last updated | 2026-06-09T12:53:39Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- curated package history
- pkgdb category and tag curation