Upgrade from Gogs

Gogs versions up to 0.9.115 can be smootlhy upgraded to Gitea.

There are some steps to do so below. On Unix run as your Gogs user:

  • Create a Gogs backup with gogs dump. This creates gogs-dump-[timestamp].zip file containing all your Gogs data.
  • Download the file matching your platform from the downloads page
  • Put the binary at the desired install location
  • Copy gogs/custom/conf/app.ini to gitea/custom/conf/app.ini
  • If you have custom templates, public in gogs/custom/ copy them to gitea/custom/.
  • If you have any other custom folders like gitignore, label, license, locale, readme in gogs/custom/conf copy them to gitea/custom/options.
  • Copy gogs/data/ to gitea/data/. It contains issue attachments and avatars.
  • Verify by starting Gitea with gitea web
  • Enter Gitea admin panel on the UI, run Rewrite '.ssh/authorized_keys' file, then run Rewrite all update hook of repositories (needed when custom config path is changed).

Change gogs specific information:

  • Rename gogs-repositories/ to gitea-repositories/
  • Rename gogs-data/ to gitea-data/
  • In your gitea/custom/conf/app.ini change:

FROM:

[database]
PATH = /home/:USER/gogs/data/:DATABASE.db
[attachment]
PATH = /home/:USER/gogs-data/attachments
[picture]
AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars
[log]
ROOT_PATH = /home/:USER/gogs/log

TO:

[database]
PATH = /home/:USER/gitea/data/:DATABASE.db
[attachment]
PATH = /home/:USER/gitea-data/attachments
[picture]
AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars
[log]
ROOT_PATH = /home/:USER/gitea/log
  • Verify by starting Gitea with gitea web

Add Gitea to startup on Unix

Update the appropriate file from gitea/scripts with the right environment variables.

For distro’s with systemd:

  • Copy the updated script to /etc/systemd/system/gitea.service
  • Add the service to the startup with: sudo systemctl enable gitea
  • Disable old gogs startup script: sudo systemctl disable gogs

For distro’s with SysVinit:

  • Copy the updated script to /etc/init.d/gitea
  • Add the service to the startup with: sudo rc-update add gitea
  • Disable old gogs startup script: sudo rc-update del gogs