docs: document FORGEJO_BASE_URL (self-hosted Forgejo host for the backend integration)

Offen Anfängerfreundlich
#1,069 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

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

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus OpenHands/docs

Alle Issues in OpenHands/docs

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.