Skip to content

Latest commit

 

History

History
86 lines (59 loc) · 1.75 KB

README.md

File metadata and controls

86 lines (59 loc) · 1.75 KB
Raw

git-cgi-server

Simple Git Smart HTTP Server (using git-http-backend) written in Go.

What is Git Smart HTTP?

See: https://git-scm.com/book/en/v2/Git-on-the-Server-Smart-HTTP

Features

  • Cross-platform
  • Simple and lightweight
  • Support HTTP authentication (Basic and Digest)
  • Support TLS

Motivation

  • I don't want to open SSH only for Git access.
  • I don't want to use rich HTTP servers (such as Apache, nginx, etc.) only for Git.
  • I don't want to change owner of repositories to the httpd user (such as httpd, www-data, etc.)
  • I want to launch easily without any complex installation and configuration.

Requirement

  • Git (including git-http-backend)

Installation

Use go get or just download binary releases.

go get github.com/pasela/git-cgi-server

Usage

git-cgi-server [OPTIONS] [REPOS_DIR]

Export all repositories:

git-cgi-server --export-all /path/to/repos

Enable Basic authentication:

git-cgi-server --basic-auth-file=/path/to/.htpasswd --auth-realm=MyGitRepos /path/to/repos

Use TLS:

git-cgi-server --cert-file=/path/to/server.crt --key-file=/path/to/server.key /path/to/repos

See git-cgi-server -h for more options.

Running git-cgi-server behind reverse proxy server

You can also serve git-cgi-server with reverse proxy.

Apache example: /etc/httpd/conf.d/git.conf

# Git Smart HTTP
ProxyPass /git http://localhost:10789/git
ProxyPassReverse /git http://localhost:10789/git
git-cgi-server" \
    --addr=:10789 \
    --digest-auth-file=/path/to/.htdigest \
    --auth-realm=Git \
    --uri-prefix=/git/ \
    --export-all \
    /path/to/repos

License

Apache 2.0 License

Author

Yuki (a.k.a. pasela)