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

未关闭 适合新手
#1,069 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

@remote-controlled-man 已经在做这个了。

开始于 2026年11月4日。

  • #1072 来自 @remote-controlled-man —— 未关闭

评估

难度
1/5
预计耗时
1 小时以内
新手友好度
85/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
documentation
领域
documentation

调研方向

缺口位于 openhands/usage/environment-variables.mdx 中:git 提供商部分列出了 FORGEJO_TOKEN,但没有 FORGEJO_BASE_URL。请对照 openhands/app_server/integrations/forgejo/service/base.py 检查默认值和描述,该变量在那里被读取。完成标准是:在 FORGEJO_TOKEN 旁边添加一行 FORGEJO_BASE_URL,默认值为 https://codeberg.org/api/v1,并交叉引用 ALLOW_INSECURE_GIT_ACCESS。

由索引模型根据 Issue 内容生成。

描述

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.

主要语言
MDX
星标
19
派生
104
平均合并
2 天 12 小时
30 天内合并 PR
80

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

OpenHands/docs 的其他 Issue

查看 OpenHands/docs 的全部 Issue

相似的 Issue

更多 Documentation Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。