Get Forgejo

You can get the binaries or container images for Forgejo as explained below. For more information on how to setup and configure Forgejo, checkout the installation guide.

Installation from binary

Download

The following instructions are for installing the latest Forgejo release on a Linux system with the amd64 architecture.
For other platforms and architectures, be sure to find the appropriate files and modify the instructions below accordingly.
A mirror of the releases is available in case codeberg.org can not be accessed. To use it replace codeberg.org with code.forgejo.org

wget https://codeberg.org/forgejo/forgejo/releases/download/v7.0.2/forgejo-7.0.2-linux-amd64
chmod +x forgejo-7.0.2-linux-amd64

Verify GPG signature

All Forgejo binaries are signed with our GPG key to verify their authenticity and guard against unwanted modification.
To validate the signature, download the signature file which ends in .asc for the binary you downloaded and use the GPG command line tool:

gpg --keyserver keys.openpgp.org --recv EB114F5E6C0DC2BCDD183550A4B61A2DC5923710
wget https://codeberg.org/forgejo/forgejo/releases/download/v7.0.2/forgejo-7.0.2-linux-amd64.asc
gpg --verify forgejo-7.0.2-linux-amd64.asc forgejo-7.0.2-linux-amd64

Container image

Forgejo provides container images for use with Docker or other containerization tools.

Install the latest release on Docker as follows:

docker pull codeberg.org/forgejo/forgejo:7.0.2

A mirror of the releases is available in case codeberg.org can not be accessed. To use it replace codeberg.org with code.forgejo.org

Upgrade from Gitea

Forgejo is a fully-compatible drop-in replacement for Gitea.

When migrating from Gitea to the Forgejo release with the same release number (eg from Gitea v1.19 to Forgejo v1.19), all that is necessary is to replace the Gitea binary with the Forgejo binary (or change the container image).

When upgrading to Forgejo from an older version of Gitea, please follow the upgrade instructions in the Forgejo documentation.

Documentation

The Forgejo documentation is now available!
It includes an extensive user guide and admin guide to help you get started, whether you're hosting Forgejo yourself or using a public instance.