docs: document FORGEJO_BASE_URL (self-hosted Forgejo host for the backend integration)
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
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de OpenHands/docs
-
docs(sdk): custom-tools 'register_tool' example passes a factory function, which raises TypeErrorAberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 62/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 83/100
Mantenedores costumam responder em até 1 dia
-
Docs: Child Conversations incorrectly implies the child's result is returned to the parentTalvez já em andamento @sahithib20 assumiu há 36 dias. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
Mantenedores costumam responder em até 1 dia
-
enhancement
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
OpenHands/docs#658 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
agent-in-progress
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 65/100
Mantenedores costumam responder em até 1 dia
Todas as issues de OpenHands/docs
Issues semelhantes
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not existTalvez já em andamento @franpts2 assumiu hoje. Abertadocs
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 90/100
Mantenedores costumam responder em até 3 dias
-
postgresql-rules / queue-rules: implicit KEY SHARE before a parent key update, and job self-overlapAberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
jonathanong/no-mistakes#3879 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
cloudflare/nimbus#423 ·
Mantenedores costumam responder em até 1 dia
-
review developer setup docAberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100
NYCPlanning/data-engineering#2996 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
Mantenedores costumam responder em até 2 dias