aiforge/docs/content/doc/upgrade/from-gogs.en-us.md

• Upgrade from Gogs
• • • Change gogs specific information:
    • Troubleshooting
    • Add Gitea to startup on Unix

Upgrade from Gogs

Gogs, version 0.9.146 and older, can be easily migrated to Gitea.

There are some basic steps to follow. On a Linux system run as the Gogs user:

• Create a Gogs backup with gogs dump. This creates gogs-dump-[timestamp].zip file
  containing all important Gogs data.
• Download the file matching the destination 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.
• Copy custom templates, public from gogs/custom/ to gitea/custom/.
• For any other custom folders, such as 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.
• If custom or config path was changed, run Rewrite all update hook of repositories.

Change gogs specific information:

• Rename gogs-repositories/ to gitea-repositories/
• Rename gogs-data/ to gitea-data/
• In 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

Troubleshooting

• If errors are encountered relating to custom templates in the gitea/custom/templates
  folder, try moving the templates causing the errors away one by one. They may not be
  compatible with Gitea or an update.

Add Gitea to startup on Unix

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

For distros 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 distros 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