2 files changed, 92 insertions, 0 deletions
diff --git a/docs/content/doc/help/seek-help.zh-cn.md b/docs/content/doc/help/seek-help.zh-cn.md
new file mode 100644
index 0000000000..ac62b9b8cf
--- /dev/null
+++ b/docs/content/doc/help/seek-help.zh-cn.md
@@ -0,0 +1,23 @@
+---
+date: "2017-01-20T15:00:00+08:00"
+title: "需要帮助"
+slug: "seek-help"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "help"
+    name: "需要帮助"
+    weight: 20
+    identifier: "seek-help"
+---
+
+## 需要帮助?
+
+如果您在使用或者开发过程中遇到问题，请到以下渠道咨询：
+
+- 到[Github issue](https://github.com/go-gitea/gitea/issues)提问(因为项目维护人员来自世界各地，为保证沟通顺畅，请使用英文提问)
+- 中文问题到[gocn.io](https://gocn.io/topic/Gitea)提问
+- 访问 [Discord server - 英文](https://discord.gg/NsatcWJ)
+- 加入 QQ群 328432459 获得进一步的支持
diff --git a/docs/content/doc/help/troubleshooting.en-us.md b/docs/content/doc/help/troubleshooting.en-us.md
new file mode 100644
index 0000000000..aa9af456ae
--- /dev/null
+++ b/docs/content/doc/help/troubleshooting.en-us.md
@@ -0,0 +1,69 @@
+---
+date: "2016-11-08T16:00:00+02:00"
+title: "Troubleshooting"
+slug: "troubleshooting"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "Help"
+    name: "Troubleshooting"
+    weight: 20
+    identifier: "troubleshooting"
+---
+
+# Troubleshooting
+
+This page contains some common issues you can run into and their solutions.
+
+## SSH issues
+
+If you are having issues with reaching your repositories over `ssh` while the
+Gitea web front-end and `https` based git operations work fine, consider
+looking at the following items.
+
+```
+Permission denied (publickey).
+fatal: Could not read from remote repository.
+
+Please make sure you have the correct access rights
+and the repository exists.
+```
+
+This error signifies that the server rejected your log in attempt, check the
+following things:
+
+* On the client:
+  * Ensure the public and private ssh keys are added to the correct Gitea user.
+  * Make sure there are no issues in your remote url, ensure the name of the
+    git user (before the `@`) is spelled correctly.
+  * Ensure the public and private ssh keys are available and reachable on the
+    client machine.
+  * Try to `ssh git@myremote.example` to ensure that everything is set up
+    properly.
+* On the server:
+  * Check the permissions of the `.ssh` directory in the home directory of your
+    `git` user.
+  * Verify that the correct public keys are added to `.ssh/authorized_keys`.
+    Try to run `Rewrite '.ssh/authorized_keys' file (for Gitea SSH keys)` on the
+    Gitea admin panel.
+
+If you get a similar error without the public key part (shown below) then
+authentication succeeded, but some other setting is preventing ssh from
+reaching the correct repository.
+
+```
+fatal: Could not read from remote repository.
+
+Please make sure you have the correct access rights
+and the repository exists.
+```
+
+In this case, look into the following settings:
+
+* On the server:
+  * Make sure that your `git` user has a usable shell set. You can verify this
+    with `getent passwd git | cut -d: -f7`, `chsh` can be used to modify this.
+  * Ensure that the `gitea serv` command in `.ssh/authorized_keys` uses the
+    proper configuration file.