Skip to content

Latest commit

 

History

History
53 lines (33 loc) · 2.14 KB

README.md

File metadata and controls

53 lines (33 loc) · 2.14 KB

Simple Git HTTP Server

This repository provides a Dockerized solution to host a Git HTTP server. It allows for basic Git operations over the HTTP protocol, such as push and pull. The server is lightweight and is intended for simple use cases where a full-fledged Git server is not required.

Contents

The repository consists of two main files:

  1. Dockerfile: Defines the Docker image that runs the Git HTTP server using Alpine Linux, Nginx, and git-http-backend.

  2. nginx.conf: Configuration file for Nginx that sets up the necessary routing for Git operations.

Getting Started

To get the Git HTTP server up and running, follow these steps:

  1. Build the Docker Image: From the repository directory, build the Docker image using the following command:

    docker build -t simple-git-http-server .

  2. Run the Docker Container: Start a container from the built image, mapping the desired host port to the container's port 80 and mounting the host directory where the Git repositories will be stored:

    docker run -d -p 4080:80 -v /path/to/host/gitdir:/git simple-git-http-server

    Replace /path/to/host/gitdir with the path to your desired directory on the host system.

  3. Initialize and Configure a Git Repository: To create a new Git repository that can be accessed over HTTP, run:

    cd /path/to/host/gitdir
git init --bare <repo>.git
cd <repo>.git
git config http.receivepack true

    Replace <repo>.git with your repository name. git config http.receivepack true is required to enable unauthenticated pushes to the repository.

  4. Access Repositories: Your repositories will be accessible at http://localhost:4080/git/<repo>.git. Replace <repo>.git with your actual repository name.

Notes

  • This server uses git-http-backend to serve Git content. It supports both fetch and push operations over HTTP.
  • The server does not include any form of authentication by default, meaning push operations are unrestricted.
  • SSL is not configured, so all communication is unencrypted.

License

This project is open source and available under the MIT License.