# HOWTO Gitea upgrades, a guide for admins

**URL:** <https://forum.gitea.com/t/howto-gitea-upgrades-a-guide-for-admins/5283>\
**Category:** Install/Maintain/Configure\
**Created:** [May 29, 2022, 8:39am UTC](https://forum.gitea.com/t/howto-gitea-upgrades-a-guide-for-admins/5283 "2022-05-29T08:39:09Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![dachary](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.gitea.com/dachary/32/4990_2.png) [@dachary](https://forum.gitea.com/u/dachary)\
**Post date:** [May 29, 2022, 8:39am UTC](https://forum.gitea.com/t/howto-gitea-upgrades-a-guide-for-admins/5283/1 "2022-05-29T08:39:10Z")

</div>

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](https://github.com/go-gitea/gitea/releases/tag/v1.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](https://github.com/go-gitea/gitea/pull/19832), [2](https://github.com/go-gitea/gitea/pull/19822), [3](https://github.com/go-gitea/gitea/pull/19762),…), add features to `gitea doctor` ([1](https://github.com/go-gitea/gitea/pull/19731), [2](https://github.com/go-gitea/gitea/pull/19656), …), analyze [complicated problems](https://hostea.org/blog/path-not-found/), fix bugs ([1](https://github.com/go-gitea/gitea/pull/19765), [2](https://github.com/go-gitea/gitea/pull/19598), …) and backport them to the latest stable version ([1](https://github.com/go-gitea/gitea/pull/19770), [2](https://github.com/go-gitea/gitea/pull/19629), …). 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.

> **[HOWTO Forgejo upgrades, a guide for admins](https://forum.gna.org/t/howto-forgejo-upgrades-a-guide-for-admins/39)**
>
> ⚠ As of July 2022, this guide moved to its own repository and will be updated there. ⚠ This guide helps Gitea admins perform upgrades safely and provides guidance to troubleshoot problems. It covers Gitea 1.2.0 and above. Backup In all cases...

---

<div class="post-metadata">

**Author:** ![Pilou](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.gitea.com/pilou/32/1784_2.png) [@Pilou](https://forum.gitea.com/u/Pilou)\
**Post date:** [May 30, 2022, 11:38pm UTC](https://forum.gitea.com/t/howto-gitea-upgrades-a-guide-for-admins/5283/2 "2022-05-30T23:38:55Z")

</div>

> [@dachary](#):
>
> This is the first version of a guide that helps Gitea admins perform upgrades safely and provides guidance to diagnose errors and troubleshoot problems

Do you plan to improve the [existing upgrade guide](https://docs.gitea.io/en-us/upgrade-from-gitea/) ([src](https://github.com/go-gitea/gitea/tree/main/docs/content/doc/upgrade)) ?

---

<div class="post-metadata">

**Author:** ![dachary](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.gitea.com/dachary/32/4990_2.png) [@dachary](https://forum.gitea.com/u/dachary)\
**Post date:** [May 31, 2022, 4:58am UTC](https://forum.gitea.com/t/howto-gitea-upgrades-a-guide-for-admins/5283/3 "2022-05-31T04:58:07Z")

</div>

Yes 🙂 A pull request was [merged a few hours ago](https://github.com/go-gitea/gitea/pull/19832/files), another was [opened right now](https://github.com/go-gitea/gitea/pull/19845/files) and more are to come ✨

Every effort is made to reduce the size of this guide by improving the Gitea documentation ([1](https://github.com/go-gitea/gitea/pull/19832), [2](https://github.com/go-gitea/gitea/pull/19822), [3](https://github.com/go-gitea/gitea/pull/19762),…), add features to `gitea doctor` ([1](https://github.com/go-gitea/gitea/pull/19731), [2](https://github.com/go-gitea/gitea/pull/19656), …), analyze [complicated problems](https://hostea.org/blog/path-not-found/), fix bugs ([1](https://github.com/go-gitea/gitea/pull/19765), [2](https://github.com/go-gitea/gitea/pull/19598), …) and backport them to the latest stable version ([1](https://github.com/go-gitea/gitea/pull/19770), [2](https://github.com/go-gitea/gitea/pull/19629), …). The ultimate goal is to make Gitea upgrades so robust and straightforward that there is no need for such a guide.