Gogs — Painless Self-Hosted Git Service

What it is

Gogs is a self-hosted Git service built with Go that provides a clean web interface for hosting Git repositories. It includes issue tracking, pull requests, code review, built-in wiki, webhooks, and organization management.

Gogs targets small teams and individual developers who want a private Git hosting solution that runs on minimal hardware -- even a Raspberry Pi -- without the resource overhead of GitLab or Gitea.

How it saves time or tokens

Gogs is a single binary with embedded assets and templates. There is no separate web server, no Node.js build step, and no external dependencies beyond a database. Deployment takes minutes instead of hours, and the low resource footprint means it can run alongside other services on budget hardware.

How to use

1. Download and run the Gogs binary:

# Binary install
wget https://dl.gogs.io/0.13.0/gogs_0.13.0_linux_amd64.tar.gz
tar -xzf gogs_0.13.0_linux_amd64.tar.gz && cd gogs
./gogs web

1. Or run via Docker:

docker run -d --name=gogs -p 3000:3000 -v gogs-data:/data gogs/gogs

1. Open the web UI and complete the first-run setup wizard to configure your database and admin account.

Example

# Clone a repository from your Gogs instance
git clone http://your-gogs-server:3000/username/repo.git

# Push a new repository
mkdir myproject && cd myproject
git init && git add . && git commit -m 'init'
git remote add origin http://your-gogs-server:3000/username/myproject.git
git push -u origin main

Related on TokRepo

• Self-Hosted Tools -- More self-hosted developer tools and services
• DevOps Tools -- Git hosting fits the DevOps toolchain

Common pitfalls

• Gogs uses XORM and supports SQLite, MySQL, PostgreSQL, and MSSQL. SQLite is simplest for single-user setups but does not handle concurrent writes well.
• Gogs and Gitea share a common codebase origin. Gitea has more contributors and features but also higher resource usage. Pick based on your scale needs.
• SSH key management requires the Gogs binary to have access to the authorized_keys file. Misconfigured SSH causes clone failures over SSH protocol.