Skip to content

hotio/mergerfs

Important Announcement

Due to scarf.sh after all this time still being on various block lists used by PiHole or other ad blockers, the use of cr.hotio.dev is halted. As you can see from the examples, ghcr.io is the new default, but if you insist on needing an older tag, you might have to pull it from docker.io (Docker Hub).

GitHub
docker.io / ghcr.io

Starting the container

1
2
3
4
5
6
7
8
docker run --rm \
    --init \
    -v /<host_folder_branch_1>:/branch_1 \
    -v /<host_folder_branch_2>:/branch_2 \
    -v /<host_folder_mountpoint>:/mountpoint:shared \
    --cap-add SYS_ADMIN \
    --device /dev/fuse \
    ghcr.io/hotio/mergerfs -o allow_other /branch_1:/branch_2 /mountpoint

The default ENTRYPOINT is mergerfs -f.

Tags

Tags Description Last Updated Age

Using the mergerfs mount on the host

By setting the bind-propagation to shared on the volume mountpoint, like this -v /data/mountpoint:/mountpoint:shared, you are able to access the mount from the host. If you want to use this mount in another container, the best solution is to create a volume on the parent folder of that mount with bind-propagation set to slave. For example, -v /data:/data:slave (/data on the host, would contain the previously created volume mountpoint). Doing it like this will ensure that when the container creating the mount restarts, the other containers using that mount will recover and keep working.

Extra docker privileges

On some systems you'll also need the following privileges.

--security-opt apparmor:unconfined