mirror of
https://github.com/trapexit/mergerfs.git
synced 2026-11-19 14:36:36 -05:00
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.
92 lines
2.1 KiB
Markdown
92 lines
2.1 KiB
Markdown
# 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/<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
|
|
```
|