Skip to content
This repository was archived by the owner on Dec 2, 2017. It is now read-only.

Commit 9f559a1

Browse files
committed
Update the migration docs
1 parent f9665c3 commit 9f559a1

File tree

1 file changed

+48
-34
lines changed

1 file changed

+48
-34
lines changed

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

Lines changed: 48 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -20,42 +20,56 @@ Gogs versions up to 0.9.97 can be smootlhy upgraded to Gitea.
2020
There are some steps to do so below.
2121
Make sure to complete them as the gitea user in ~:
2222

23-
* Stop Gogs
24-
* cd ~
25-
* wget https://github.com/go-gitea/gitea/archive/v1.0.0.zip
26-
* unzip v1.0.0.zip
27-
* cp -r gogs gitea
28-
* If you have custom content migrated from gogs/custom/ folder, like templates or localization files, you should manually merge these because these files changed on Gitea.
29-
* cp -r gitea-v1.0.0/options gitea/options
30-
* cp -r gogs-repositories/ gitea-repositories
31-
* cp -r gogs-data/ gitea-data/
32-
* vim gitea/custom/conf/app.ini
33-
34-
Change gogs specific information:
23+
* Download the file matching your platform from the [downloads page](https://dl.gitea.io/gitea)
24+
* Unzip at the desired install location
25+
* Copy Gogs `custom/conf` to Gitea
26+
* Copy `data/` folder from Gogs to Gitea. It contains issue attachments and avatars.
27+
* Verify by starting Gitea with `gitea web`
28+
* Enter Gitea admin panel on the UI, run `Rewrite '.ssh/authorized_keys' file` (caution: non-Gitea keys will be lost) and `Rewrite all update hook of repositories` (needed when custom config path is changed).
29+
30+
31+
### Change gogs specific information:
32+
33+
* Rename `gogs-repositories/` to `gitea-repositories/`
34+
* Rename `gogs-data/` to `gitea-data/`
35+
* In your gitea/custom/conf/app.ini change:
3536

3637
FROM:
37-
* [database]
38-
* PATH = /home/:USER/gogs/data/:DATABASE.db
39-
* [attachment]
40-
* PATH = /home/:USER/gogs-data/attachments
41-
* [picture]
42-
* AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars
43-
* [log]
44-
* ROOT_PATH = /home/:USER/gogs/log
38+
39+
[database]
40+
PATH = /home/:USER/gogs/data/:DATABASE.db
41+
[attachment]
42+
PATH = /home/:USER/gogs-data/attachments
43+
[picture]
44+
AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars
45+
[log]
46+
ROOT_PATH = /home/:USER/gogs/log`
4547

4648
TO:
47-
* [database]
48-
* PATH = /home/:USER/gitea/data/:DATABASE.db
49-
* [attachment]
50-
* PATH = /home/:USER/gitea-data/attachments
51-
* [picture]
52-
* AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars
53-
* [log]
54-
* ROOT_PATH = /home/:USER/gitea/log
55-
56-
Verify working by running gitea
57-
58-
* ~/gitea/gitea web
59-
* Enter Gitea admin panel on the UI, run `Rewrite '.ssh/authorized_keys' file` (caution: non-Gitea keys will be lost) and `Rewrite all update hook of repositories` (needed when custom config path is changed).
6049

61-
Update the gitea-v1.0.0/scripts file for your specific distro and environment then copy.
50+
[database]
51+
PATH = /home/:USER/gitea/data/:DATABASE.db
52+
[attachment]
53+
PATH = /home/:USER/gitea-data/attachments
54+
[picture]
55+
AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars
56+
[log]
57+
ROOT_PATH = /home/:USER/gitea/log
58+
59+
* Verify by starting Gitea with `gitea web`
60+
61+
62+
### Add Gitea to startup on Unix
63+
Update the appropriate file from [gitea/scripts](https://github.com/go-gitea/gitea/tree/master/scripts) with the right environment variables.
64+
65+
For distro's with systemd:
66+
67+
* Copy the updated script to `/etc/systemd/system/gitea.service`
68+
* Add the service to the startup with: `sudo systemctl enable gitea`
69+
* Disable old gogs startup script: `sudo systemctl disable gogs`
70+
71+
For distro's with open-rc:
72+
73+
* Copy the updated script to `/etc/init.d/gitea`
74+
* Add the service to the startup with: `sudo rc-update add gitea`
75+
* Disable old gogs startup script: `sudo rc-update del gogs`

0 commit comments

Comments
 (0)