Skip to content

docs: Forgejo LTS is the platform's forge (ADR-0034) - #89

Merged
Teg79 merged 4 commits into
mainfrom
docs/forgejo-forge
Nov 18, 2026
Merged

Teg79 merged 4 commits into
mainfrom
docs/forgejo-forge

Conversation

@Teg79

@Teg79 Teg79 commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • docs/decisions/0034-forgejo-lts-forge.md (new): Forgejo LTS is the platform's forge.
    • Why: Gitea 1.24 is out of support; Forgejo 15 is LTS until 15 July 2027; adoption among self-hosters; the spike's results.
    • How we follow its releases: the newest patch of the current LTS, pinned by digest per urbex release; the next LTS before the end of support.
    • Names: forge in the code and docs, the new credential and config keys with the old ones still read; what keeps its name on existing platforms.
    • What we give up (Gitea 28's bot accounts and audit log) and the fallback (Gitea 28).
  • ADR-0004 and ADR-0018: Status points to ADR-0034.
  • docs/known-limitations.md: a platform installed with urbex 0.1.0 stays on Gitea 1.24 and isn't migrated in place (Forgejo imports Gitea databases only up to 1.22): rebootstrap, or push the repos again; its workspace keeps working.
  • The reference:
    • credentials.md: forgeAdminPassword, forgeToken, URBEX_FORGE_*, the legacy names, and Komodo's variable kept;
    • platform-config.md: git.forgeUrl, giteaUrl still read;
    • cli.md: the logins and --output json keys;
    • platform-resources.md: the forge LXC.
  • Gitea → Forgejo in the docs, the README and the skills (138 mentions), except where Gitea itself is meant. Infrastructure names (urbex-gitea, gitea-data, the service gitea) are unchanged. One anchor renamed with its links.
  • Plugin 0.2.1: the skills use the new keys; the cli skill's token check accepts giteaToken too (a workspace from 0.1.0).

Depends on urbforge/urbex-cli#116.

Why

urbforge/urbex-cli#112: the spike passed, so the switch and its decision are recorded before the first testers.

Tests I ran

  • Relative links and anchors of the changed pages: all resolve.
  • tests/plugin-scripts.sh: passes.
  • Every remaining "Gitea" outside the ADRs reviewed by hand.

Checklist before review

  • Linked issue, Conventional Commit title
  • ADR with Status, Context, Decision, Rationale, Consequences; earlier ADRs point to it
  • Relative links and anchors resolve
  • Plugin version bumped (0.2.1)
  • No secrets, tokens or private addresses

Part of urbforge/urbex-cli#112.

🤖 Generated with Claude Code

https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA
@Teg79
Teg79 merged commit c175630 into main Nov 18, 2026
@Teg79

Teg79 commented Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

Merged without a new review on Teg's OK: only the '### Plugin 0.2.1' and Docs entries in CHANGELOG.md, and two merges of main (the second resolving a conflict in docs/known-limitations.md: main's rows, with Forgejo's name), after Stefano's approval.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants