Forgejo v1.21 is available

Forgejo v1.21.1-0 is here and you will find the most interesting changes it introduces below. Before upgrading it is strongly recommended to make a full backup as explained in the upgrade guide and carefully read all breaking changes from the release notes. If in doubt, do not hesitate to ask for help on the Fediverse, or in the chat room.

Read more in the Forgejo v1.21.1-0 release notes.

Forgejo Actions

Forgejo is only as stable and robust as the test infrastructure that verifies it works. Forgejo Actions is not just a feature, it is an integral part of what makes Forgejo whole. With v1.21 this self-sustainable ecosystem grew with more components such as end to end testing and upgrade tests running older versions of Forgejo. Each repository is independent but it is not isolated from the others. Developers do not need to manually keep them in sync, they are bound together with tests. As more components are added, these tests will be the cement keeping them together, allowing developers to focus on what matters.

Forgejo ecosystem

Server side the most notable improvements are:

Forgejo Actions is however not yet production ready, for the reasons explained in the Forgejo v1.20 blog post.

Client side, the newer version of the Forgejo runner that is responsible for running the workflows now comes in two flavors:

It is tested with itself to verify a new version does not introduce a trivial regression that would break Forgejo, using an action to cascade pull requests between repositories.

Read more about Forgejo actions in the user guide and in the administrator guide.

What is unique to Forgejo?

Until recently all Forgejo commits could have been merged into Gitea overnight. But as of October 2023 Gitea requires a copyright assignment in addition to the MIT license. It means that the most significant contributions such as blocking a user will not be merged into Gitea and are unique to Forgejo v1.21 and later.

Forgejo continues to include all of Gitea and guarantees a 100% drop-in replacement for Gitea admins. No action is required, it is enough to replace the Gitea binary or the container image with the equivalent Forgejo release and restart.

Such an upgrade may be motivated to benefit from security fixes that only exist in Forgejo, such as the Long-term authentication vulnerability which is fixed since Forgejo v1.20.5-0 and will also be in Gitea v1.22 early 2024.


Does Forgejo support federation? Not yet. Was there progress? Yes.

The monthly reports have details on these progress and the State of the Forge Federation: 2023 edition published in June 2023 explains how Forgejo fits in the big picture.

Forges have existed for over twenty years and none of them has achieved data portability let alone federation. Forgejo is yet to celebrate the publication of its first release and it will take it a little time to get there.

Get Forgejo v1.21

See the download page for instructions on how to install Forgejo, and read the release notes for more information.


Carefully read the breaking changes section of the release notes.

The actual upgrade process is as simple as replacing the binary or container image with the corresponding Forgejo binary or container image. If you’re using the container images, you can use the 1.21 tag to stay up to date with the latest 1.21.x point release automatically.

Make sure to check the Forgejo upgrade documentation for recommendations on how to properly backup your instance before the upgrade. It also covers upgrading from Gitea, as far back as version 1.2.0. Forgejo includes all of Gitea v1.21.

Contribute to Forgejo

If you have any feedback or suggestions for Forgejo do not hold back, it is also your project. Open an issue in the issue tracker for feature requests or bug reports, reach out on the Fediverse, or drop into the Matrix space (main chat room) and say hi!