# 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](https://github.com/trapexit/mergerfs). ``` $ git clone https://github.com/trapexit/mergerfs.git $ # or $ wget https://github.com/trapexit/mergerfs/releases/download//mergerfs-.tar.gz ``` ## Debian / Ubuntu ``` $ cd mergerfs $ sudo buildtools/install-build-pkgs $ make deb $ sudo dpkg -i ../mergerfs__.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//mergerfs-..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/-env.source` activation script and the older `/opt/rh/gcc-toolset-/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 ```