selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitProxy logo

Self-host GitProxy

v2.3.0

Git push proxy with custom security policies

ReleaseOpen SourceApache-2.0
Updated5 days ago
LanguageTypescript
Setup difficultyModerate
Stars
262
Ports
8000 (Git proxy HTTP server), 8443 (Git proxy HTTPS server), 8080 (UI/API HTTP server), 8444 (UI/API HTTPS server), 2222 (SSH proxy server)
Docker
finos/git-proxy
Install with Docker

What is GitProxy?

GitProxy is a self-hosted tool that sits between developers and Git servers like GitHub or GitLab to enforce custom push rules. Every push gets checked by a configurable pipeline — scanning for secrets with gitleaks, validating commit messages and author emails, detecting hidden commits, and running pre-receive hooks — before the push is either blocked or allowed through. It works the same way over both HTTP/HTTPS and SSH, with SSH agent forwarding keeping private keys on the developer's machine. You can install it via npm, run the Docker image from Docker Hub, or build from source. The web UI supports local accounts, ActiveDirectory/LDAP, and OpenID Connect for login. Data can be stored in an embedded file database (NeDB), MongoDB, or PostgreSQL. The project comes from the FINOS foundation and aims at regulated sectors like finance that need standard git workflows with compliance controls.

Should you self-host GitProxy?

GitProxy scores 52/100 on selfhost.directory (how scoring works) and ranks #39 of 78 in Security. It has 262 GitHub stars.

It shipped 8 stable releases in the past year. The latest, v2.3.0, came out on 17 October 2026.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is pentagi (83/100, 32 629 stars). It scores higher overall, so compare the two before you pick. See GitProxy vs pentagi side by side.

Features

  • Attestation workflow
  • Audit Logging
  • Author email validation
  • Commit message validation
  • Dynamic configuration reload
  • Hidden commit detection
  • HTTP/HTTPS proxy
  • Multiple Authentication Methods
  • Plugin System
  • Pre-receive hooks
  • Secret Detection
  • SSH proxy
  • Upstream proxy support
  • Web Dashboard

GitProxy README

How to install GitProxy

Install GitProxy with Docker

Docker
Environment variables
GIT_PROXY_SERVER_PORT, GIT_PROXY_UI_PORT, GIT_PROXY_HTTPS_UI_PORT, ALLOWED_ORIGINS, API_URL, NODE_ENV

docker run -d
--name git-proxy
-p 8000:8000
-p 8080:8080
-v $(pwd)/proxy.config.json:/app/proxy.config.json:ro
finos/git-proxy:latest

Published image on Docker Hub

GitProxy releases & version history

More in Security

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…