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

Commit 0e6b943

Browse files
committed
Update the migration docs
1 parent f9665c3 commit 0e6b943

File tree

1 file changed

+52
-36
lines changed

1 file changed

+52
-36
lines changed

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

Lines changed: 52 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -15,47 +15,63 @@ menu:
1515

1616
# Upgrade from Gogs
1717

18-
Gogs versions up to 0.9.97 can be smootlhy upgraded to Gitea.
18+
Gogs versions up to 0.9.115.0103 can be smootlhy upgraded to Gitea.
1919

20-
There are some steps to do so below.
21-
Make sure to complete them as the gitea user in ~:
20+
There are some steps to do so below. On Unix run as your Gogs user:
2221

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
22+
* Create a Gogs backup with `gogs dump`. This creates `gogs-dump-[timestamp].zip` file containing all your Gogs data.
23+
* Download the file matching your platform from the [downloads page](https://dl.gitea.io/gitea)
24+
* Put the binary at the desired install location
25+
* Copy `gogs/custom/conf/app.ini` to `gitea/custom/conf/app.ini`
26+
* If you have custom content in `gogs/custom/` copy that to `gitea/custom/options`. This is used to override gitignores, labels, licenses, locales and readmes.
27+
[Due to a bug](https://github.com/go-gitea/gitea/issues/529) custom templates aren't working at the moment.
28+
* Copy `gogs/data/` to `gitea/data/`. It contains issue attachments and avatars.
29+
* Verify by starting Gitea with `gitea web`
30+
* 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).
31+
32+
33+
### Change gogs specific information:
3334

34-
Change gogs specific information:
35+
* Rename `gogs-repositories/` to `gitea-repositories/`
36+
* Rename `gogs-data/` to `gitea-data/`
37+
* In your `gitea/custom/conf/app.ini` change:
3538

3639
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
40+
41+
[database]
42+
PATH = /home/:USER/gogs/data/:DATABASE.db
43+
[attachment]
44+
PATH = /home/:USER/gogs-data/attachments
45+
[picture]
46+
AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars
47+
[log]
48+
ROOT_PATH = /home/:USER/gogs/log`
4549

4650
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).
6051

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

0 commit comments

Comments
 (0)