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.
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