A daemon to mirror remote Git repositories and serve them over HTTP, automatically updating the mirror as needed.
It was developed to be used in CI environments to improve the performance of Git clone and fetch operations.
The project is a C++ clone of jonasmalacofilho's git-cache-http-server. However, there are these differences and improvements:
- The repository cache is updated sequentially and for each git fetch or clone operation to avoid race conditions when the remote is updated while some request is updating the cache.
- The authentication works by fetching or cloning the remote instead of testing if the remote is accessible using the credentials.
- It can easily be configured to run as a systemd daemon.
(It was developed on and for Debian-based platforms, it can probably also be compiled on other platforms, but don't ask me how.)
- Clone the Git repository and initialize submodules.
git clone https://github.com/craflin/git-cache-http-server.git && cd git-cache-http-server && git submodule update --init - Install zlib1g-dev.
sudo apt-get install zlib1g-dev - Build the project with CMake.
mkdir build && cd build && cmake .. && cmake --build . - You can build a deb package using the package target in CMake.
cmake --build . --target package
- Install git.
sudo apt-get install git - Install gchsd from the deb package.
wget https://github.com/craflin/git-cache-http-server/releases/download/<version>>/gchsd-<version>-<platform>.deb && sudo dpkg -i ./gchsd-<version>-<platform>.deb - If needed, configure a cache directory (default is /tmp/gchsd) and listen port (default is 80) in /etc/gchsd.conf.
- Start the gchsd daemon with
sudo systemctl daemon-reload && sudo systemctl start gchsd.- You can use
sudo systemctl enable gchsdto start the daemon automatically after a system restart.
- You can use
- Run
git config --global url."http://<mirror_server_addr>[:<port>]/https://".insteadOf https://to use the mirror instead of the original source.