Skip to content

containers/fuse-overlayfs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0d53568 · Aug 10, 2021
Aug 4, 2021
Aug 17, 2020
Sep 11, 2020
Jul 22, 2019
Aug 6, 2019
Jul 29, 2021
Aug 26, 2020
Jul 28, 2019
Feb 8, 2020
Jul 30, 2018
Oct 6, 2020
Oct 9, 2020
Oct 6, 2020
Oct 6, 2020
Oct 9, 2020
Aug 10, 2021
Oct 6, 2020
May 9, 2020
Jul 4, 2018
Aug 10, 2021
Aug 4, 2021
Jun 1, 2021
Jun 1, 2021
Jul 2, 2021
Nov 18, 2019
Aug 9, 2021
Apr 15, 2020
Nov 27, 2019
Oct 24, 2019
Nov 11, 2020
Mar 4, 2021

Repository files navigation

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:

If your are not using the static build as explained in the next chapter, your system needs libfuse > v3.2.1.

  • On Fedora: dnf install fuse3-devel
  • On Ubuntu > v19.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.

Static Build:

This project provides a convenient way to automatically perform a static build using a container. The result is a self-contained binary without dependencies, that can be copied across hosts.

  1. Install buildah as explained here;

  2. Both the build and deploy host require the special device /dev/fuse; there are a few ways to obtain it:

  • install fuse2 or fuse3 using the package manager of your choice (dnf, apt, pacman, etc): the install script will usually create the device automatically; or
  • manually create the device with the command mknod /dev/fuse -m 0666 c 10 229 (see this code)
  1. Clone this repository, and switch to the top-level folder containing the file "Containerfile.static.ubuntu";

  2. Launch the build with the command (note the single dot . at the end):

buildah bud -v $PWD:/build/fuse-overlayfs -t fuse-overlayfs -f ./Containerfile.static.ubuntu .
  1. Copy the resulting binary to your host:
sudo cp fuse-overlayfs /usr/bin/