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

Abierto Apto para principiantes
#1,069 0 comentarios 0 reacciones 0 asignados Ver en GitHub

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

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

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de OpenHands/docs

Todos los issues de OpenHands/docs

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.