# GotHub

> Open-source, self-hosted front-end for GitHub written in Go: pages serve plain HTML and CSS with no JavaScript and requests to GitHub proxied away from your browser.

- **Category:** [Developer Tools](https://selfhost.directory/developer-tools)
- **Source model:** Open source
- **Latest version:** 1.0.0
- **Author:** GotHub
- **Platforms:** Docker, Docker Compose, Build from Source
- **Ports:** 3000 (GotHub's own HTTP server, exposed to the reverse proxy in front of it)
- **Tags:** Privacy, Proxy, Tor, No JavaScript, Go, Front end, Alternative frontend, Web scraper, GitHub

## Docker images

- [`codeberg.org/gothub/gothub`](https://codeberg.org/gothub/gothub) — Main web application image published on the Codeberg container registry; dev and latest tags track the two branches.

## What is GotHub?

GotHub is a web front-end for GitHub that instance operators run themselves: you replace github.com with the instance's domain and browse repositories, gists and user pages without code executing in your browser. Written in Go, it pulls GitHub data through a Colly-powered scraper and renders plain HTML and CSS, which keeps pages tiny — the README's PageSpeed comparison of one repository measured 3 requests and 8kb of resources against GitHub's 88 requests and 629kb. Operators can choose whether avatars, repository archives and raw files are proxied through the instance, and the outgoing user agent is configurable. Hosting is documented as a container image on the Codeberg registry (docker run or the project's compose.yml) or as a manual build from source with Go, followed by a setup wizard that writes a .env file and a built-in update command. The project has no expenses of its own and asks donors to give to whichever instance host they prefer, while official public instances are barred from ads and web analytics. GotHub is still marked as work in progress, seeks volunteers to take over maintenance, and publishes no tagged releases.

## Should you self-host GotHub?

GotHub scores **53/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#70 of 167** in [Developer Tools](https://selfhost.directory/developer-tools).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available.

Its closest alternative on selfhost.directory is [RhodeCode](https://selfhost.directory/project/rhodecode) (64/100). It scores higher overall, so compare the two before you pick. [See GotHub vs RhodeCode side by side.](https://selfhost.directory/compare/gothub-vs-rhodecode)

## Features

- Built-in update command
- Configurable User-Agent
- Explore page — GitHub's own explore content is not covered by the scraper.
- Gist support
- GitHub scraping with Colly
- Lightweight pages
- No-JavaScript UI
- Optional asset proxying
- Public instance directory
- Setup Wizard
- Stable and development branches
- Tor access on some instances (◐ partial) — Offered per instance, not by the software itself.
- Upstream requests proxied by the instance

## How to install GotHub

### Install GotHub with Docker

Requirements: Docker (duh)
- A web server (we recommend Caddy)

Environment variables:

```
GOTHUB_PORT, GOTHUB_USER_AGENT, GOTHUB_PROXYING_ENABLED, GOTHUB_INSTANCE_COUNTRY, GOTHUB_INSTANCE_PROVIDER, GOTHUB_INSTANCE_PRIVACY_POLICY, GOTHUB_INSTANCE_CLOUDFLARE, GOTHUB_SETUP_COMPLETE, GOTHUB_CACHE_MAX_SIZE_MB, DOCKER
```

```bash
docker run -d --name gothub -p 3000:3000 codeberg.org/gothub/gothub:dev
```

Note: Image lives on the Codeberg registry; use the latest tag for the master branch. An automatic container update tool such as Watchtower is recommended.

### Install GotHub with Docker Compose

```bash
mkdir gothub
cd gothub
wget https://codeberg.org/gothub/gothub/raw/branch/dev/compose.yml
docker compose up -d
```

Note: The compose.yml should be edited: several environment variables are needed for listing on the instance list.

### Install GotHub with Build from Source

Environment variables:

```
GOTHUB_PORT, GOTHUB_USER_AGENT and the instance variables
```

```bash
git clone https://codeberg.org/gothub/gothub.git
git checkout master
```

```bash
go build -ldflags="-X codeberg.org/gothub/gothubs/utils.Branch=$(git rev-parse --abbrev-ref HEAD)"
```

```bash
./gothub setup
```

```bash
./gothub serve
```

Note: Pass --port to "gothub serve" to override GOTHUB_PORT; "./gothub update" pulls and rebuilds.

## GotHub is a self-hosted alternative to

- [GitHub](https://selfhost.directory/alternative-to/github)

## GotHub alternatives

- [self-forge](https://selfhost.directory/project/self-forge): self-forge mirrors public GitHub repos and serves them via a minimal, server-rendered web UI with no JavaScript or CSS. (compare: https://selfhost.directory/compare/gothub-vs-self-forge)
- [Gogs](https://selfhost.directory/project/gogs): A lightweight, open-source, self-hosted Git service written in Go: repos, issues, pull requests, wikis and LDAP login, run from one binary or a Docker image. (compare: https://selfhost.directory/compare/gogs-vs-gothub)
- [Gitus](https://selfhost.directory/project/gitus): Gitus is a self-hosted, open-source Git forge in Go with no JavaScript, featuring a web installer, SSH access, issues, pull requests, and experimental webhooks. (compare: https://selfhost.directory/compare/gitus-vs-gothub)
- [legit](https://selfhost.directory/project/legit): Open-source, self-hosted browsing UI for Git repos, built in Go: serves bare repositories from a folder with custom templates, README rendering and HTTP cloning. (compare: https://selfhost.directory/compare/gothub-vs-legit)
- [goblin](https://selfhost.directory/project/goblin): Self-hosted service compiling Go binaries on-demand via HTTP, letting users install Go tools without Go installed. Open-source alternative to gobinaries.com. (compare: https://selfhost.directory/compare/goblin-vs-gothub)
- [Copilot_Proxy](https://selfhost.directory/project/copilotproxy): Self-hosted proxy that converts GitHub Copilot API into OpenAI, Anthropic, and Gemini compatible endpoints with a WebUI for multi-account management and token handling. (compare: https://selfhost.directory/compare/copilotproxy-vs-gothub)
- [MirrorProxy](https://selfhost.directory/project/mirrorproxy): MirrorProxy is a self-hosted, open-source mirror acceleration gateway for GitHub, Docker/OCI, language packages, and Linux/BSD repos with access control and quotas. (compare: https://selfhost.directory/compare/gothub-vs-mirrorproxy)
- [gobookmarks](https://selfhost.directory/project/gobookmarks): gobookmarks is a self-hosted start page rendering bookmarks from a plain text file with visual editor, search, and Git-backed history. (compare: https://selfhost.directory/compare/gobookmarks-vs-gothub)

## More in Developer Tools

- [Grafana-Image-Renderer](https://selfhost.directory/project/grafana-image-renderer): Self-hosted backend service using headless Chromium to render Grafana panels as PNG, PDF, or CSV for sharing and alerts.
- [grafeas](https://selfhost.directory/project/grafeas): Grafeas is an open-source, self-hosted artifact metadata API for auditing software supply chains by storing and querying metadata about container images.
- [Grai Core](https://selfhost.directory/project/grai-core): Grai is a self-hosted, open-source data lineage platform with pre-built connectors for Snowflake, BigQuery, dbt, and more.
- [Graphiti](https://selfhost.directory/project/omni-verse-reader): Graphiti is a self-hosted, open-source scene graph engine for interactive 3D data visualization with real-time peer-to-peer sync via WebRTC and CRDTs — no cloud required.
- [graphql-meter](https://selfhost.directory/project/graphql-meter): Self-hosted GraphQL load testing platform that auto-discovers schema operations and runs tests via Locust or k6 with live monitoring and run comparison.
- [gravitee](https://selfhost.directory/project/gravitee): Self-hosted, open-source API management: gateway, 50+ policies, developer portal and analytics for REST, GraphQL and gRPC APIs, run via Docker Compose or Helm.
- [Greenmask](https://selfhost.directory/project/greenmask): An open-source CLI utility that masks PostgreSQL database dumps and creates synthetic test data for CI/CD workflows.
- [Grix](https://selfhost.directory/project/grix): Grix is a self-hosted messaging platform that turns AI coding agents into chat contacts for cross-device coordination with shared context and voice support.
- [grokbuild-proxy](https://selfhost.directory/project/grokbuild-proxy): Self-hosted proxy translating Anthropic and OpenAI API requests to Grok Build, letting you use your personal Grok account with Claude Code and compatible clients.
- [grok-reg-tool](https://selfhost.directory/project/grok-reg-tool): Self-hosted web console automating Grok registration with DrissionPage, email verification, SSO output, and local account pool management.
- [Grok UI](https://selfhost.directory/project/grok-ui): Grok UI is a self-hosted, local-first command center for Grok Build with live runtime monitoring, ACP session control, Git tracking, and fleet monitoring.
- [guardian-wallet](https://selfhost.directory/project/guardian-wallet): A self-hosted wallet for AI agents that uses threshold cryptography to split keys into three shares, with policy controls and developer SDKs.

## Links

- [Homepage](https://codeberg.org/gothub/gothub)
- [Website](https://gothub.app)
- [GotHub Matrix room](https://matrix.to/#/#gothub:matrix.org)
- [GotHub documentation](https://codeberg.org/gothub/docs)
- [Instance list (JSON)](https://codeberg.org/gothub/gothub-instances)

---
Source: https://selfhost.directory/project/gothub