summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Speicher <robert@gitlab.com>2015-09-24 17:03:12 +0000
committerRobert Speicher <rspeicher@gmail.com>2015-09-24 14:27:53 -0400
commitbd859cd8512ece96bf97cb6208d06768efb3a76b (patch)
tree5b740c76f5361ca75fa559bb8537384631cff32f
parent55d771104c2e5b61dbbca3eeb3f2eec9542d7394 (diff)
downloadgitlab-ce-bd859cd8512ece96bf97cb6208d06768efb3a76b.tar.gz
Merge branch 'rs-troubleshooting' into 'master'
Add Troubleshooting section to 8.0 docs [ci skip] See merge request !1416
-rw-r--r--doc/install/installation.md10
-rw-r--r--doc/update/7.14-to-8.0.md10
2 files changed, 20 insertions, 0 deletions
diff --git a/doc/install/installation.md b/doc/install/installation.md
index 5887891c1ab..039bb3c2561 100644
--- a/doc/install/installation.md
+++ b/doc/install/installation.md
@@ -518,3 +518,13 @@ You also need to change the corresponding options (e.g. `ssh_user`, `ssh_host`,
### Additional Markup Styles
Apart from the always supported markdown style there are other rich text files that GitLab can display. But you might have to install a dependency to do so. Please see the [github-markup gem readme](https://github.com/gitlabhq/markup#markups) for more information.
+
+## Troubleshooting
+
+### "You appear to have cloned an empty repository."
+
+If you see this message when attempting to clone a repository hosted by GitLab,
+this is likely due to an outdated Nginx or Apache configuration, or a missing or
+misconfigured `gitlab-git-http-server` instance. Double-check that you've
+[installed Go](#3-go), [installed gitlab-git-http-server](#install-gitlab-git-http-server),
+and correctly [configured Nginx](#site-configuration).
diff --git a/doc/update/7.14-to-8.0.md b/doc/update/7.14-to-8.0.md
index 2c7003ed063..30d1826b473 100644
--- a/doc/update/7.14-to-8.0.md
+++ b/doc/update/7.14-to-8.0.md
@@ -190,3 +190,13 @@ sudo -u git -H bundle exec rake gitlab:backup:restore RAILS_ENV=production
```
If you have more than one backup `*.tar` file(s) please add `BACKUP=timestamp_of_backup` to the command above.
+
+## Troubleshooting
+
+### "You appear to have cloned an empty repository."
+
+If you see this message when attempting to clone a repository hosted by GitLab,
+this is likely due to an outdated Nginx or Apache configuration, or a missing or
+misconfigured `gitlab-git-http-server` instance. Double-check that you correctly
+completed [Step 5](#5-install-gitlab-git-http-server) to install the daemon and
+[Step 8](#new-nginx-configuration) to reconfigure Nginx.