Catalog · Server

Forgejo

Forgejo is a self-hosted software forge for Git repositories, issues, pull requests, wikis, package registries and CI. It started as a fork of Gitea and is developed as a community project; Codeberg e.V. runs the best-known public instance. It runs as a single binary or container and works with SQLite, PostgreSQL or MySQL.

Code Fireworks render of the Forgejo repository, as of Nov 2026
As of Nov 2026Code Fireworks ↗

Why it fits

Since v9.0 it is licensed under GPL version 3.0 or later. You can run a private Git service without relying on a commercial SaaS.

Getting started

6 steps · clarity 4/5

Prerequisites (from the official docs):

  • A Linux host with Docker (a single binary install is also documented)
  • Free ports for the web interface (default 3000) and Git over SSH
  • SQLite for small setups, or PostgreSQL/MySQL
  • A reverse proxy with TLS if the forge is reachable from the internet

Steps:

  1. Create a directory for Forgejo data and the Compose file.
  2. Write the docker-compose.yml from the official Docker guide.
  3. Chown the data directory to the UID/GID the guide requires.
  4. Start the stack with docker compose up -d.
  5. Open http://<server>:3000.
  6. Submit the initial configuration form (SQLite is fine for small setups) and create the admin account.

Official Docker installation guide: https://forgejo.org/docs/latest/admin/installation/docker/

All installation methods: https://forgejo.org/docs/latest/admin/installation/

Notes

Funding note points at NLnet’s general project index; specific grant line items were not individually re-audited.

Sources

  1. forgejo.org
  2. codeberg.org/forgejo/forgejo/src/branch/forgejo/LICENSE
  3. forgejo.org/docs/latest/admin/installation
  4. nlnet.nl/project/Forgejo
  5. forgejo.org/docs/latest/admin/installation/docker

More in Server

← Back to the catalog