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
-
難度 1/5 1 小時以內 新手友好度 85/100
-
難度 1/5 1 小時以內 新手友好度 90/100
ethereum/execution-apis#1017 ·
維護者通常 3 天內回覆
-
[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 小時 新手友好度 72/100
pearu/agent-sandbox#451 ·
維護者通常 1 天內回覆