bensuperpc/distcc repository overview

⁠docker-distcc

Distcc (and ccache) in docker !

⁠Features

• Support for multiple systems (Ubuntu, Debian, Arch, Fedora, Alpine)
• Distcc (and ccache)
• Easy to use and configure

⁠Requirements

• Docker⁠
• GNU Make⁠
• GCC⁠
• Distcc⁠
• CMake⁠
• Ninja⁠
• ccache⁠

⁠Usage

⁠Run

First, you need to run the container. You can use the following command:

Note: You can replace debian-11 with ubuntu-20.04, archlinux-rolling, fedora-34 or alpine-3.14 ect...

docker run -d -p 3632:3632 -p 3633:3633 bensuperpc/distcc:debian-11 --allow 0.0.0.0/0

Second, you need to configure your environment to use the container. You can use the following command:

Note: You need to replace X with the number of cores you want to use, and if you want, localhost with the IP of the container.

export DISTCC_HOSTS='localhost/X localhost:3632/X'

For Cmake, you can use the following command:

Note: We use Ninja as a generator for build speed but you can use Make or other generators.

cmake -DCMAKE_C_COMPILER_LAUNCHER="ccache;distcc" -DCMAKE_CXX_COMPILER_LAUNCHER="ccache;distcc" -S . -B build -G Ninja && cmake --build build

For Make, you can use the following command:

Note: You can replace X with the number of cores you want to use.

make -jX CC="distcc gcc" CXX="distcc g++"

⁠Build

You can build the image using the following command:

Note: You can replace debian with ubuntu, archlinux or alpine.

make debian

With tests: Note: Currently, the tests doesn't return an error code if the tests failed.

make debian.test

⁠Supported systems (Table)

⁠Contributing

If you want to contribute to this project, you can do it by opening a pull request or an issue.

⁠Open source projects used

• buildroot⁠
• CMake⁠
• Make⁠
• llvm-project⁠
• gcc⁠
• docker⁠
• actions⁠

⁠Sources

• redhat.com⁠
• medium.com⁠
• linux.die.net⁠

⁠Licensing

MIT LICENSE