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

Aberta Para iniciantes
#1,069 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@remote-controlled-man já está trabalhando nisso.

Desde 4/11/2026.

  • #1072 de @remote-controlled-man — aberto

Avaliação

Dificuldade
1/5
Tempo estimado
Menos de uma hora
Facilidade para iniciantes
85/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
documentation
Domínio
documentation

Direção de pesquisa

A lacuna está em openhands/usage/environment-variables.mdx, onde a seção de provedores git lista FORGEJO_TOKEN, mas não FORGEJO_BASE_URL. Confira o valor padrão e a redação em openhands/app_server/integrations/forgejo/service/base.py, onde a variável é lida. Está concluído quando há uma linha para FORGEJO_BASE_URL ao lado de FORGEJO_TOKEN, com o padrão https://codeberg.org/api/v1 e uma referência cruzada a ALLOW_INSECURE_GIT_ACCESS.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.

Linguagem predominante
MDX
Estrelas
19
Forks
104
Merge médio
2d 12h
PRs com merge (30d)
80

Preparar o ambiente

  • Sem Dockerfile nem arquivo Docker Compose
  • Tem um modelo de pull request
  • Sem guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de OpenHands/docs

Todas as issues de OpenHands/docs

Issues semelhantes

Mais issues de Documentation

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.