docs: document FORGEJO_BASE_URL (self-hosted Forgejo host for the backend integration)
Maintainer antworten meist innerhalb von 1 Tag
@remote-controlled-man arbeitet bereits daran.
Seit 04.11.2026.
- #1072 von @remote-controlled-man — offen
Bewertung
- Schwierigkeit
- 1/5
- Geschätzter Aufwand
- Unter einer Stunde
- Anfängerfreundlichkeit
- 85/100
- Issue-Typ
- Dokumentation
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- documentation
- Bereich
- documentation
Rechercherichtung
Die Lücke liegt in openhands/usage/environment-variables.mdx: Im Abschnitt zu Git-Providern ist FORGEJO_TOKEN aufgeführt, FORGEJO_BASE_URL dagegen nicht. Prüfe Standardwert und Formulierung anhand von openhands/app_server/integrations/forgejo/service/base.py, wo die Variable gelesen wird. Fertig ist es, wenn neben FORGEJO_TOKEN eine Zeile für FORGEJO_BASE_URL steht, mit dem Standardwert https://codeberg.org/api/v1 und einem Querverweis auf ALLOW_INSECURE_GIT_ACCESS.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Problem
FORGEJO_BASE_URL is a supported environment variable — the enterprise/sandbox-server app-server reads it to
point the Forgejo integration at a self-hosted instance:
# openhands/app_server/integrations/forgejo/service/base.py
DEFAULT_BASE_URL = 'https://codeberg.org/api/v1'
env_base_url = os.environ.get('FORGEJO_BASE_URL')
self.BASE_URL = self._resolve_base_url(base_url, base_domain, env_base_url)
But the environment-variables reference documents FORGEJO_TOKEN and not FORGEJO_BASE_URL. A user
trying to connect a self-hosted Forgejo (Agent Canvas split install) could only find FORGEJO_TOKEN, so it
was unclear how to set the host — and whether a custom MCP server was needed (it isn't).
Where
openhands/usage/environment-variables.mdx — the git-provider section lists FORGEJO_TOKEN only.
Suggested fix
Add a row for FORGEJO_BASE_URL (string, default https://codeberg.org/api/v1) alongside FORGEJO_TOKEN,
noting that it should be the API base URL of the self-hosted Forgejo instance, and cross-reference
ALLOW_INSECURE_GIT_ACCESS for plain-HTTP internal instances.
Reported by
A user (bitheadtech) asking how to point the backend at a self-hosted Forgejo; docs gap confirmed against
the app-server source.
This issue was created by an AI agent (OpenHands) on behalf of the maintainer.
- Vorherrschende Sprache
- MDX
- Sterne
- 19
- Forks
- 104
- Ø Merge
- 2 T. 12 Std.
- Gemergte PRs (30 T.)
- 80
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Kein Beitragsleitfaden
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus OpenHands/docs
-
docs(sdk): custom-tools 'register_tool' example passes a factory function, which raises TypeErrorOffen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 83/100
Maintainer antworten meist innerhalb von 1 Tag
-
Docs: Child Conversations incorrectly implies the child's result is returned to the parentEvtl. vergeben @sahithib20 hat das vor 36 Tagen übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
Maintainer antworten meist innerhalb von 1 Tag
-
enhancement
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
OpenHands/docs#658 · 2 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
agent-in-progress
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 65/100
Maintainer antworten meist innerhalb von 1 Tag
Ähnliche Issues
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 90/100
ethereum/execution-apis#1017 ·
Maintainer antworten meist innerhalb von 3 Tagen
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not existEvtl. vergeben @franpts2 hat das heute übernommen. Offendocs
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 90/100
Maintainer antworten meist innerhalb von 3 Tagen
-
postgresql-rules / queue-rules: implicit KEY SHARE before a parent key update, and job self-overlapOffen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
jonathanong/no-mistakes#3879 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
pearu/agent-sandbox#451 ·
Maintainer antworten meist innerhalb von 1 Tag