book-git-commands/src/hosting/updating-gitea.md

Updating Gitea

See https://docs.gitea.io/en-us/install-from-binary/#updating-to-a-new-version for more information.

The following covers what I've done for my instance.

Create a backup

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
5. exit

Update 1.16.8 to 1.16.9

1. VERSION=1.16.9
2. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
3. sudo systemctl status gitea
   • Stop if needed/didn't backup.
4. sudo mv gitea /usr/local/bin/gitea
5. sudo chmod +x /usr/local/bin/gitea
6. sudo systemctl restart gitea
7. sudo systemctl status gitea
8. After some period of time, delete the backup file.

Updating 1.16.9 to 1.17.1

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
   • rm <old-backup-file>
5. exit
6. VERSION=1.17.1
7. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
8. sudo systemctl status gitea
9. sudo mv gitea /usr/local/bin/gitea
10. sudo chmod +x /usr/local/bin/gitea
11. sudo systemctl restart gitea
12. sudo systemctl status gitea
13. After some period of time, delete the backup file.

Updating 1.17.1 to 1.17.2

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
   • rm <old-backup-file>
5. exit
6. VERSION=1.17.2
7. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
8. sudo systemctl status gitea
   • Should be inactive/dead.
9. sudo mv gitea /usr/local/bin/gitea
10. sudo chmod +x /usr/local/bin/gitea
11. sudo systemctl restart gitea
12. sudo systemctl status gitea
    • Should be active (running).
13. After some period of time, delete the backup file.

Updating 1.17.2 to 1.17.3

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
   • rm <old-backup-file>
5. exit
6. VERSION=1.17.3
7. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
8. sudo systemctl status gitea
   • Should be inactive/dead.
9. sudo mv gitea /usr/local/bin/gitea
10. sudo chmod +x /usr/local/bin/gitea
11. sudo systemctl restart gitea
12. sudo systemctl status gitea
    • Should be active (running).
13. After some period of time, delete the backup file.

Gitea LFS config also updated:

1. sudo vim /etc/gitea/app.ini
2. Move server.LFS_CONTENT_PATH to a new lfs.PATH (/var/lib/gitea/data/lfs).
3. sudo systemctl restart gitea
4. sudo systemctl status gitea

Updating 1.17.3 to 1.17.4

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
   • rm <old-backup-file>
   • chmod a=r <new-backup-file>
5. exit
6. VERSION=1.17.4
7. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
8. sudo systemctl status gitea
   • Should be inactive/dead.
9. sudo mv gitea /usr/local/bin/gitea
10. sudo chmod +x /usr/local/bin/gitea
11. sudo systemctl restart gitea
12. sudo systemctl status gitea
    • Should be active (running).
13. After some period of time, delete the backup file.

Updating 1.17.4 to 1.18.0

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
   • rm <old-backup-file>
   • chmod a=r <new-backup-file>
5. exit
6. VERSION=1.18.0
7. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
8. sudo systemctl status gitea
   • Should be inactive/dead.
9. sudo mv gitea /usr/local/bin/gitea
10. sudo chmod +x /usr/local/bin/gitea
11. sudo systemctl restart gitea
12. sudo systemctl status gitea
    • Should be active (running).
13. After some period of time, delete the backup file.

Updating 1.18.0 to 1.18.3

Updates came pretty fast, so I ran all three of these one after the other.

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
   • rm <old-backup-file>
   • chmod a=r <new-backup-file>
5. exit
6. VERSION=1.18.1
7. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
8. sudo systemctl status gitea
   • Should be inactive/dead.
9. sudo mv gitea /usr/local/bin/gitea
10. sudo chmod +x /usr/local/bin/gitea
11. sudo systemctl restart gitea
12. sudo systemctl status gitea
    • Should be active (running).
13. Test the site.
14. sudo systemctl stop gitea
15. VERSION=1.18.2
16. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
17. sudo mv gitea /usr/local/bin/gitea
18. sudo chmod +x /usr/local/bin/gitea
19. sudo systemctl restart gitea
20. Test.
21. sudo systemctl stop gitea
22. VERSION=1.18.3
23. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
24. sudo mv gitea /usr/local/bin/gitea
25. sudo chmod +x /usr/local/bin/gitea
26. sudo systemctl restart gitea
27. Test.
28. After some period of time, delete the backup file.

Updating 1.18.3 to 1.18.5

1.18.4 included a bug.

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
   • rm <old-backup-file>
   • chmod a=r <new-backup-file>
5. exit
6. VERSION=1.18.5
7. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
8. sudo systemctl status gitea
   • Should be inactive/dead.
9. sudo mv gitea /usr/local/bin/gitea
10. sudo chmod +x /usr/local/bin/gitea
11. sudo systemctl restart gitea
12. sudo systemctl status gitea
    • Should be active (running).
13. After some period of time, delete the backup file.

Updating 1.18.5 to 1.19.0

1. sudo systemctl stop gitea
2. sudo su - git
3. gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp
4. ls -l --block-size=M
   • rm <old-backup-file>
   • chmod a=r <new-backup-file>
5. exit
6. VERSION=1.19.0
7. sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
8. sudo systemctl status gitea
   • Should be inactive/dead.
9. sudo mv gitea /usr/local/bin/gitea
10. sudo chmod +x /usr/local/bin/gitea
11. sudo systemctl restart gitea
12. sudo systemctl status gitea
    • Should be active (running).
13. After some period of time, delete the backup file.