Forgejo is a self-hosted lightweight software forge. Easy to install and low maintenance, it just does the job.

Built in Go, looks like.

Delightful Forgejo

Official resources

Resources maintained as part of the primary Forgejo project.
- ![][forgejo] Forgejo website
- ![][forgejo] Forgejo documentation
- ![][forgejo] Forgejo issue tracker
- ![][forgejo] Forgejo releases (RSS feed; Release notes)
- ![][forgejo] Forgejo runner
- ![][forgejo] Forgejo container images
- ![][forgejo] Forgejo Mastodon account
- ![][forgejo] Forgejo identity proofs (Keyoxide)

Documentation

In addition to ![][forgejo] Forgejo's official documentation, the following resources may be useful.

Codeberg documentation - contains some Codeberg-specific parts but is mostly applicable to every Forgejo instance.
Gitea documentation - mostly applicable to Forgejo as well as Gitea.

Tutorials

Forgejo in a nutshell - guide to setup Forgejo.
Forgejo with LFS behind a VPN - guide to set up a Linux web server running Forgejo, Git-LFS, and a Wireguard VPN.
UberLab installation guide - Forgejo installation guide for Uberspace.
Setting up a Self-Hosted Forgejo Actions Runner with Docker Compose.
Running a runner for codeberg/forgejo on RHEL9 (Red Hat Enterprise Linux) with podman as user systemd service

Public instances

Forgejo instances with open registration.
- Codeberg - free and open for FOSS projects only, run by a German non-profit organization. Also provides hosted Woodpecker (CI) and Weblate (localisation).
- CodeFloe - free and open. Legally operated by devXY, a Swiss DevOps company. Open to community engagement and management.
Provides Crow CI and Forgejo Actions for CI/CD and a Forum for public user discussions.
- Disroot - a platform providing online services based on principles of freedom, privacy, federation and decentralization. Also provides many other free hosted services.
- pub.solar - Register/Login via pub.solar ID, run by a German tech collective with the goal to enable more people to use free software, have secure digital communications, and to take control over their private data.
- KaKi's git - free and open, run by a French web developer.
- sij.ai - Free and open platform run by a public interest environmental lawyer that is open for anyone but especially intended for AI-ML hobbyists & enthusiasts.
- git.gay - instance run by Besties, a queer collective. Uses modified version of Forgejo.
- bolha.dev - instance run by bolha.us, and bolha.io a Brazilian IT collective. Running the vanilla version.

Packaging

Platform-specific packages to easily install and update Forgejo on your system. These are generally maintained either by distro packagers or by community volunteers.

Also see forgejo package versions on Repology.
- Alpine
- Alpine community forgejo package
- Alpine community forgejo-lts package
- Arch Linux
- Arch extra forgejo package

Debian/Ubuntu
- Unofficial forgejo-deb packages + repo
Fedora
- Fedora forgejo package
- RPM copr repo
FreeBSD
- Port www/forgejo / package forgejo - binary packages available in latest and quarterly 2024Q2 or newer.
Gentoo
- Gentoo GURU www-apps/forgejo package
Kubernetes
- Helm chart - Helm chart for Forgejo, forked from the official Gitea helm chart
- c4k-forgejo - Convention 4 Kubernetes, generates a kubernetes manifest for Forgejo including backup & monitoring.
NixOS
- NixOS forgejo service
Snapcraft
- Unofficial forgejo snap package - building in launchpad
Termux (Android)
- Termux forgejo package
YunoHost
- YunoHost package - install Forgejo quickly and simply on a YunoHost server

CI/CD

CI/CD tools that integrate via Forgejo officially or inofficially.

Forgejo Actions - the integrated CI/CD solution with external runners. See below.
Woodpecker CI - a community-maintained powerful CI/CD based on Docker containers, historically forked from Drone CI.
- Crow CI - a soft-fork of Woodpecker CI.
Jenkins - an extensible CI/CD with a large plugin ecosystem.
- Gitea Plugin - use Jenkins with Forgejo (API-compatible to Gitea).
- Gitea Checks Plugin - use Forgejo status checks with Jenkins.
yoyo Sourcehut CI bridge - develop on Forgejo and run builds within the Sourcehut CI.
agola - containerized and flexible CI/CD platform.
Buildbot - a flexible CI/CD framework. Can be used with a plugin.
mvoCI - a simple and personal CI/CD solution.

Forgejo Actions

Learn about Forgejo actions in the ![][forgejo] Actions admin guide and ![][forgejo] Actions user guide.

Actions runners

![][forgejo] Forgejo runner - supports LXC & Docker & shell with binaries for GNU/Linux (amd64, arm64)
act runner - supports Docker & shell with binaries for GNU/Linux (amd64, arm64, arm[567]), FreeBSD, Windows, MacOS

Actions runner deployment tools

forgejo-hetzner-runner - Deploy Forgejo Actions runners on Hetzner infrastructure
helm-chart - Deploy a Forgejo Actions runner on the specified Forgejo instance

Actions

trust-self-signed-cert - Trust a self-signed SSL certificate for future operations (e.g. checkout action).
forgejo-todo-checker - Checks your source files for TODO and FIXME comments, where they don't have an open issue number.
forgejo-commit-path-rules - Enforce consistency between commit messages and file changes in your repository.
Native-CI - A collection of actions for helping maintain native projects (C/C++/...) that may require cross-platform builds.

Clients

CMS (Content Management System)

Sveltia CMS - Configurable admin panel for static site generator authoring.
DecapCMS (repo) - Configurable admin panel for static site generator authoring.

Mobile

GitNex (repo) - Android client for Forgejo and Gitea (Android – GPL)
👻 GitTouch - Mobile client for Forgejo, Gitea, GitHub, GitLab, Bitbucket (Android, iOS – Apache)

Command-line

codeberg-cli - CLI tool for Forgejo similar to gh, glab and tea (cross-platform - AGPL)
forgejo-cli - CLI tool for interacting with Forgejo (cross-platform - Apache/MIT)
![][forgejo] forgejo-curl - a thin curl wrapper that helps with Forgejo authentication
tea - the official Gitea CLI client, works with Forgejo (cross-platform – MIT)

Emacs

fj.el - a basic Emacs client for Forgejo.

Tools

Infrastructure as Code

Terraform & Ansible playbook - Deploy Forgejo, Minio, Nginx & Woodpecker in the cloud via Docker Compose, depends on related geerlingguy playbooks.
Terraform Provider for Forgejo - Allows managing resources (organizations, repositories, users) within Forgejo.
Ansible Collection l3d.git.gitea - Ansible collection to install and configure forgejo.

Monitoring

Monitoring plugin to check Forgejo instance upgrade status has the sources and is published in the Icinga exchange repository.

Bots

👻 gitcat - Python script that allows sign-up to a Forgejo instance to all local users of a Mastodon server. (Python - GPLv3)
Renovate - Dependency update tool (similar to dependabot) with Forgejo support. (TypeScript - AGPLv3)
Nayrah - A Discord bot that retrieves various information from a Forgejo instance like Codeberg. (Python - AGPLv3)
👻 forgejo-guardian - Simple Forgejo instance guardian, banning users and alerting admins based on certain regular expressions. (Rust - AGPLv3)
git-next - Trunk-based development manager (with Forgejo & Github support).

Scripts

github2gitea/github2forgejo - Bash script that creates mirrors for various GitHub resources like orgs, users and starred repos (incl. private repos). (Bash - AGPLv3)
Enhancements for Forgejo - Violentmonkey userscript that adds minor UX improvements to the web UI. (JavaScript - MIT)

Package deployment

lein-forgejo-wagon - Leiningen plugin for deployment and downloading of JARs in Maven repositories hosted on Forgejo packages.

API client libraries

Cyborus/forgejo-api - Rust crate to interact with the Forgejo API (Rust - Apache or MIT)
harabat/pyforgejo - Python client library to interact with the Forgejo API (Python - MIT)
mvdkleijn/forgejo-sdk - Go client library to interact with the Forgejo API (fork of gitea/go-sdk) (Go - MIT)
forgejo-js - JavaScript / Typescript
library to interact with the Forgejo API (fork of gitea-js) (JavaScript / Typescript - MIT)

Forks

Actively maintained Forgejo forks.

Fordj - a git-based design-platform for the AEC (Architecture, Engineering and Construction).
Forgejo-aneksajo - (temporary) fork of Forgejo that adds an integration with git-annex.

Tags: tool cloud backend

Last modified 21 December 2025

Forgejo

Open-source cloud repository tool platform built around Git.