Forgejo v1.20 release candidates

Today the first release candidate for the upcoming Forgejo v1.20 release was published and the documentation updated. It is meant for testing only: do not upgrade a production instance with it.

The highlights are:

  • The internal CI/CD known as Forgejo Actions is now used by Forgejo for testing and releasing the Forgejo Runner. It is still in its infancy and disabled by default but it is stable and secure enough to be activated on Forgejo’s own instance. The documentation was updated to explain how to install and use it.
  • The User Interface (UI) and User eXperience (UX) changed significantly and will require some adjustment from users and admins who created their own customized templates.
  • New API features and endpoints were added (activity feeds, renaming users, uploading file, retrieving commits, etc.).
  • Essential sub-systems were refactored (the queue system that handles background tasks such as checking pull requests, the logger used to display Forgejo’s logs, …). In theory these changes are transparent to the Forgejo user and admin but the risk of subtle regressions is real: do not hesitate to reach out if you suspect anything.

The draft release notes have a categorized list of the most significant changes:

  • [A11Y] accessibility of the web interface.
  • [API] REST API.
  • [AUTH] authentication.
  • [CI] Forgejo’s own Continuous Integration.
  • [MODERATION] moderation tools.
  • [PACKAGES] package registries.
  • [REFACTOR] internal refactors.
  • [RSS] display and creation of RSS feeds.
  • [TEMPLATES] templating system used to create web pages, issues, mails, etc.
  • [TIME] time localization and readability.
  • [UI / UX] User Interface and User eXperience.
  • [WEBHOOK] webhooks and notifications triggered when something happens in Forgejo.
  • [WIKI] wiki features.

Make sure to check the breaking changes (look for the string BREAKING) and get your production instance ready for when the v1.20 release is available.

There was progress regarding federation with the integration of the F3 driver in the codebase (an essential building block to synchronize forges with each other) but nothing is ready for experimenting yet.

Try it out

The release candidate is published in the dedicated “experimental” Forgejo organization and can be downloaded from:

Checkout the v1.20 documentation section for detailed installation instructions.

It will be updated based on your feedback until it becomes robust enough to be released.

Help write good release notes

The best release notes are meant to articulate the needs and benefits of new features and the actions recommended for breaking changes so Forgejo admins quickly know if it is of interest to them.

The current draft release notes are still incomplete. They will be finished by the time the release is published and you can help make them better.

Contribute to Forgejo

If you have any feedback or suggestions for Forgejo, we’d love to hear from you! Open an issue on the issue tracker for feature requests or bug reports. You can also find us on the Fediverse, or drop by the Matrix space (main chat room) to say hi!