Files
oam/knowledge base/forgejo.md
2026-02-23 11:45:04 +01:00

2.5 KiB

Forgejo

Community-driven code forge platform similar to GitHub.
Forked from Gitea after the for-profit company Gitea Ltd took control of it.

  1. TL;DR
  2. Further readings
    1. Sources

TL;DR

Setup
docker pull 'codeberg.org/forgejo/forgejo'  # or 'data.forgejo.org/forgejo/forgejo'

The configuration uses the INI format.
When installing from a distribution, the configuration file will typically be placed at /etc/forgejo/app.ini.
When using the container image, the configuration file is automatically created if it does not already exist.
Refer the configuration cheat sheet and the configuration file defaults.

Values containing # or ; must be quoted using ` or """.

Important

Forgejo requires a full restart for configuration changes to take effect.

Configuration values can be added or overridden by setting environment variables that follow the FORGEJO__[SECTION]__[KEY] format.
The DEFAULT section of the configuration should be an empty string.

Setting environment variables as follows:

FORGEJO____APP_NAME=Frogejo 🐸
FORGEJO__repository__ENABLE_PUSH_CREATE_USER=true

is equivalent to adding the following to the app.ini configuration file:

APP_NAME=Frogejo 🐸

[repository]
ENABLE_PUSH_CREATE_USER = true

Existing configuration values must be removed by editing the configuration file.

Important

Using SELinux environments could trigger issues with containers.
Check the audit logs in this case.

Further readings

Sources