docs: document FORGEJO_BASE_URL (self-hosted Forgejo host for the backend integration)
Los mantenedores suelen responder en 1 día
@remote-controlled-man ya está trabajando en esto.
Desde el 4/11/2026.
- #1072 de @remote-controlled-man — abierto
Evaluación
- Dificultad
- 1/5
- Tiempo estimado
- Menos de una hora
- Aptitud para principiantes
- 85/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- documentation
- Área
- documentation
Línea de trabajo
La brecha está en openhands/usage/environment-variables.mdx, donde la sección de proveedores de git enumera FORGEJO_TOKEN pero no FORGEJO_BASE_URL. Verifica el valor predeterminado y la redacción frente a openhands/app_server/integrations/forgejo/service/base.py, donde se lee la variable. Está terminado cuando hay una fila de FORGEJO_BASE_URL junto a FORGEJO_TOKEN, con el valor predeterminado https://codeberg.org/api/v1 y una referencia cruzada a ALLOW_INSECURE_GIT_ACCESS.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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.
- Lenguaje dominante
- MDX
- Estrellas
- 19
- Forks
- 104
- Merge medio
- 2 d 12 h
- PR fusionados (30 d)
- 80
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de OpenHands/docs
-
docs(sdk): custom-tools 'register_tool' example passes a factory function, which raises TypeErrorAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 83/100
Los mantenedores suelen responder en 1 día
-
Docs: Child Conversations incorrectly implies the child's result is returned to the parentPosiblemente ocupada @sahithib20 la tomó hace 36 días. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día
-
enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
OpenHands/docs#658 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
agent-in-progress
Dificultad 3/5 1-2 días Aptitud para principiantes 65/100
Los mantenedores suelen responder en 1 día
Todos los issues de OpenHands/docs
Issues similares
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not existPosiblemente ocupada @franpts2 la tomó hoy. Abiertodocs
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
Los mantenedores suelen responder en 3 días
-
postgresql-rules / queue-rules: implicit KEY SHARE before a parent key update, and job self-overlapAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
jonathanong/no-mistakes#3879 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
cloudflare/nimbus#423 ·
Los mantenedores suelen responder en 1 día
-
review developer setup docAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
NYCPlanning/data-engineering#2996 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 2 días