mergerfs/mkdocs/docs/setup/build.md
Antonio SJ Musumeci bdfbedad8b Fix release builds and drop Debian 11 targets
Enable parallel Debian package builds through debhelper, remove Debian 11 release targets, and select the installed GCC Toolset activation script on Rocky Linux 10 while preserving older layouts. Update the build documentation.
2026-11-05 15:02:42 -06:00

2.1 KiB

Build

NOTE: Prebuilt packages can be found at and recommended for most users: https://github.com/trapexit/mergerfs/releases

NOTE: Only tagged releases are supported. master and other branches should be considered works in progress.

First, get the code from github.

$ git clone https://github.com/trapexit/mergerfs.git
$ # or
$ wget https://github.com/trapexit/mergerfs/releases/download/<ver>/mergerfs-<ver>.tar.gz

Debian / Ubuntu

$ cd mergerfs
$ sudo buildtools/install-build-pkgs
$ make deb
$ sudo dpkg -i ../mergerfs_<version>_<arch>.deb

Debian package compilation uses the available CPUs by default. To limit parallelism, set DEB_BUILD_OPTIONS:

$ DEB_BUILD_OPTIONS=parallel=4 make deb

RHEL / CentOS / Rocky / Fedora

$ su -
# cd mergerfs
# buildtools/install-build-pkgs
# make rpm
# rpm -i rpmbuild/RPMS/<arch>/mergerfs-<version>.<arch>.rpm

Fedora 45 rejects unsigned RPMs by default. When installing a locally built RPM that you trust, pass --nosignature to rpm to allow that unsigned package.

Rocky Linux container builds activate newer GCC Toolsets when available. Both the Rocky 10 /usr/lib/gcc-toolset/<version>-env.source activation script and the older /opt/rh/gcc-toolset-<version>/enable layout are supported.

Container packages

Package build targets are defined in buildtools/containerfiles/, with the standard distro targets listed in buildtools/target-containers.txt. Debian release builds target Debian 12 and 13. Other targets include Fedora 45 on amd64 and arm64, and Ubuntu 26.10 on amd64, arm64, armhf, and riscv64. Foreign-architecture builds require QEMU/binfmt support.

Generic Linux

Have git, g++ or clang, make, python installed.

$ cd mergerfs
$ make
$ sudo make install

FreeBSD

Have git, g++ or clang, gmake, python installed.

$ cd mergerfs
$ gmake
$ gmake install # as root

Build options

$ make help
usage: make

make USE_XATTR=0      - build program without xattrs functionality
make STATIC=1         - build static binary
make LTO=1            - build with link time optimization