Forgejo 17.0: repo-relative Links, Workflow-Run-Webhooks, Migration aus Bitbucket DC
Serguey Asael Shinder2 Min. LesezeitForgejo, die von der Community entwickelte, selbst gehostete Plattform für die Zusammenarbeit an Code, ist am 15. Oktober 2026 in Version 17.0 erschienen. Die Ankündigung des Projekts nennt eine Auswahl der Änderungen und verweist für alles Weitere auf die Release Notes. Vor dem Upgrade rät Forgejo zu einem vollständigen Backup und zur Lektüre der Breaking Changes.
Zwei Änderungen verlangen Aufmerksamkeit. In gerenderten Dokumenten werden absolute Links auf Ressourcen im Repository jetzt relativ zur Wurzel des Repositorys aufgelöst, nicht mehr relativ zur Wurzel der Instanz (!12939). In Beschreibungen und Kommentaren von Issues und Pull Requests bleibt es bei der Instanzwurzel (!13993). Laut Forgejo erhöht das die Kompatibilität mit anderen Git-Forges und erleichtert Migrationen. Der zweite Punkt trägt den Vermerk „Handlungsbedarf“: Webhook-Ereignisse für Action-Runs sind abgekündigt und werden durch Workflow-Run-Ereignisse ersetzt (!14351). Eine automatische Umstellung bestehender Webhooks gibt es nicht, weil sich einige Header (X--Event, X--Event-Type) und der Action-Schlüssel geändert haben; zudem kommen Abschlussmeldungen erst, wenn alle Jobs eines Runs beendet sind (!12598). Administratoren sollen ihre Empfänger prüfen und die Webhooks von Hand umstellen.
Forgejo Actions. Über die HTTP-API lassen sich abgeschlossene Workflow-Runs (/repos/{owner}/{repo}/actions/runs/{run_id}/rerun) und einzelne Jobs (.../actions/jobs/{job_id}/rerun) neu starten (!13924). Die Endpunkte für Job-Logs können jetzt nach Teilstrings filtern (!12821), mit ?step=N nur einen Schritt liefern (!12799) und mit ?format=ndjson NDJSON ausgeben (!12820). Job-Zusammenfassungen aus Forgejo Runner 13.2 oder neuer erscheinen über den Logs (!14076); Schritte schreiben dafür Markdown-Fragmente nach $FORGEJO_STEP_SUMMARY, auch $GITHUB_STEP_SUMMARY wird akzeptiert. Webhooks können außerdem bei Statuswechseln eines Workflow-Jobs auslösen, wobei sich die gewünschten Status auswählen lassen (!14334).
Zusammenarbeit. Repositorys mit einer Datei FUNDING.yml bekommen einen „Donate“-Button, ebenso Profile von Nutzern und Organisationen über das .profile-Repository. Wer in Issues, Pull Requests oder Kommentaren # oder ! tippt, erhält jetzt Vorschläge (!8088). Organisationen können neue Mitglieder statt sofort aufzunehmen einladen – per [service].ADD_MEMBERS_BY_INVITATIONS = true in app.ini; die Einladungen gehen per E-Mail hinaus und verfallen standardmäßig nach 14 Tagen. Nutzer lassen sich in einem Schritt mehreren Teams zuordnen (!11848), Maintainer und Autoren von Pull Requests können direkt auf AGit-Refs pushen, und die Git-LFS-Unterstützung wird überarbeitet, unter anderem mit Ansichten, welche Commits auf eine LFS-Datei verweisen.
Migration. Forgejo kann nun Repositorys aus Bitbucket Data Center (früher Bitbucket Server) übernehmen, samt Pull Requests, Reviews, mehrzeiligen Kommentaren, Threads und Antworten (!13288). Die Anmeldung läuft über ein HTTP-Access-Token, und auf Bitbucket muss „HTTPS SCM Hosting“ aktiviert sein. Bei Migrationen aus Gogs, GitLab, Gitea oder Forgejo werden jetzt auch die Avatare der Repositorys übernommen (!12921), und die Dokumentation hat eine Anleitung für Backup und Wiederherstellung erhalten.
Supportzeitraum. v17.0 ist keine LTS-Version und wird bis zum 28. Januar 2027 unterstützt. Die aktuelle LTS 15.0 läuft bis 15. Juli 2027, v16.0 erreicht ihr Ende am 29. Oktober 2026. Die nächste LTS, 19.0, ist für den 15. April 2027 geplant.
Quelle: Forgejo, „Forgejo v17.0 is available“ — https://forgejo.org/2026-10-release-v17-0/