Gitea 28.3.0: many access-check fixes, clean upgrade

released
lab run
upgraded from
28.2.0
guest
Ubuntu 26.04 VM
tested
yes, in our lab

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 gc strategy.
  • 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.

sources

other Gitea releases