docs: document FORGEJO_BASE_URL (self-hosted Forgejo host for the backend integration)
维护者通常 1 天内回复
评估
- 难度
- 1/5
- 预计耗时
- 1 小时以内
- 新手友好度
- 85/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- 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 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
OpenHands/docs 的其他 Issue
-
docs(sdk): custom-tools 'register_tool' example passes a factory function, which raises TypeError未关闭
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 83/100
维护者通常 1 天内回复
-
Docs: Child Conversations incorrectly implies the child's result is returned to the parent可能已有人在做 @sahithib20 于 36 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复
-
enhancement
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
agent-in-progress
难度 3/5 1-2 天 新手友好度 65/100
维护者通常 1 天内回复
相似的 Issue
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not exist可能已有人在做 @franpts2 今天认领。 未关闭docs
难度 1/5 1 小时以内 新手友好度 90/100
维护者通常 3 天内回复
-
postgresql-rules / queue-rules: implicit KEY SHARE before a parent key update, and job self-overlap未关闭
难度 2/5 1-3 小时 新手友好度 82/100
jonathanong/no-mistakes#3879 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 84/100
cloudflare/nimbus#423 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 70/100
NYCPlanning/data-engineering#2996 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 2 天内回复