This is the first version of a guide that helps Gitea admins perform upgrades safely and provides guidance to diagnose errors and troubleshoot problems. It covers all Gitea versions from 1.9.6 which was published in 2019 and is collectively maintained by Gitea contributors.
Every effort is made to reduce the size of this guide by improving the Gitea documentation (1, 2, 3,…), add features to gitea doctor (1, 2, …), analyze complicated problems, fix bugs (1, 2, …) and backport them to the latest stable version (1, 2, …). The ultimate goal is to make Gitea upgrades so robust and straightforward that there is no need for such a guide.
If this guide is useful to you or needs to be improved, feel free to speak up.
Every effort is made to reduce the size of this guide by improving the Gitea documentation (1, 2, 3,…), add features to gitea doctor (1, 2, …), analyze complicated problems, fix bugs (1, 2, …) and backport them to the latest stable version (1, 2, …). The ultimate goal is to make Gitea upgrades so robust and straightforward that there is no need for such a guide.
A pull request was 