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

Add troubleshooting tip. #109

Merged
merged 7 commits into from
Apr 7, 2017
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 12 additions & 9 deletions content/doc/upgrade/from-gogs.en-us.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,16 +20,15 @@ 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](https://dl.gitea.io/gitea)
* Put the binary at the desired install location
* Copy `gogs/custom/conf/app.ini` to `gitea/custom/conf/app.ini`
* Download the file matching your platform from the [downloads page](https://dl.gitea.io/gitea).
* 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`
* 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/`
Expand Down Expand Up @@ -61,10 +60,14 @@ ROOT_PATH = /home/:USER/gitea/log
```

* Verify by starting Gitea with `gitea web`



### Troubleshooting

* If you encounter errors 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.

### Add Gitea to startup on Unix
Update the appropriate file from [gitea/contrib](https://github.com/go-gitea/gitea/tree/master/contrib) with the right environment variables.

Update the appropriate file from [gitea/scripts](https://github.com/go-gitea/gitea/tree/master/scripts) with the right environment variables.

For distro's with systemd:

Expand Down