Gitea 28.3.0: many access-check fixes, clean upgrade
Summary
Gitea 28.3.0 is a maintenance release with no new headline feature. The release notes list 3 enhancements, 5 performance changes, 41 bug fixes and 1 documentation change.
Most fixes tighten access checks: public-only token scope on more routes, unit read permission in issue sub-resource endpoints, feed access, hidden linked pull requests, and external-identity auto-linking. There is also a golang.org/x/net security update to v0.62.0.
Performance work covers the issue and pull request dashboards and lists, and a fix for slow Actions job queries on SQLite. The release notes also mention fixed table indices.
Breaking changes and deprecations
The release notes list none. Some behaviour changes could surprise you:
- Review comments on locked pull requests are now refused.
- Git maintenance now defaults to the
gcstrategy. - Tighter access checks may turn some API calls that worked by accident into 403/404 responses.
These come from the release notes. We did not test them.
Tested in our lab
We installed 28.2.0 with Docker Compose (SQLite, INSTALL_LOCK set), created an admin user, a repository with an initial commit, and one issue. We then ran docker compose down, changed the image tag to 28.3.0, pulled it and started it.
After the upgrade:
- The API reported 28.3.0.
- The web UI answered HTTP 200.
- The issue and the commit were still there.
- The container logs held no error or warning lines, and no migration messages.
We did not test Actions, packages, OAuth, migrations from other forges, PostgreSQL/MySQL, or any of the permission fixes. Our data set was tiny, so we have no speed numbers.
Lab log
$ curl -s localhost:3000/api/v1/version
{"version":"28.2.0"}
$ docker compose down
[...]
Container gitea Removed
$ sed -i "s/gitea:28.2.0/gitea:28.3.0/" compose.yml
$ docker compose pull
$ docker compose up -d
Container gitea Starting
Container gitea Started
$ curl -s localhost:3000/api/v1/version
{"version":"28.3.0"}
$ curl -s -o /dev/null -w "%{http_code}\n" localhost:3000/
200
$ curl -s -u lab:[redacted] localhost:3000/api/v1/repos/lab/demo/issues | grep -o "\"title\":\"[^\"]*\""
"title":"first issue"
$ curl -s -u lab:[redacted] "localhost:3000/api/v1/repos/lab/demo/commits" | grep -o "\"message\":\"[^\"]*\""
"message":"Initial commit\n"
$ docker logs gitea 2>&1 | grep -iE "\[(E|W)\]|error|migrat"
$ docker ps --format "{{.Status}}"
Up 18 seconds
Reported by others
Nothing beyond the release notes. We did not look for user reports of problems.
Verdict
Upgrade soon. The access-check and security dependency fixes are a good reason, and our simple Docker/SQLite upgrade from 28.2.0 worked without trouble. Back up your data directory first, as with any upgrade. If you use Actions, external authentication or many users, test on a copy first, since we did not cover those.