From e8ce9639da161fca0053cdaeba4a822d4dd71771 Mon Sep 17 00:00:00 2001 From: Robert Speicher Date: Wed, 23 Sep 2015 20:36:17 -0400 Subject: [PATCH 1/3] Add Troubleshooting section to Install guide --- doc/install/installation.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/install/installation.md b/doc/install/installation.md index 5887891c1ab..282c84fd1e1 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 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). From 6e65108325ef77ab66466700011b7d2d419ebc5a Mon Sep 17 00:00:00 2001 From: Robert Speicher Date: Wed, 23 Sep 2015 20:36:25 -0400 Subject: [PATCH 2/3] Add Troubleshooting section to 7.14 to 8.0 Update guide --- doc/update/7.14-to-8.0.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/update/7.14-to-8.0.md b/doc/update/7.14-to-8.0.md index 2c7003ed063..e25b38a3533 100644 --- a/doc/update/7.14-to-8.0.md +++ b/doc/update/7.14-to-8.0.md @@ -190,3 +190,12 @@ 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 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. From 58c21dd77b5a6573d50a62dc17755a6519f4a9c8 Mon Sep 17 00:00:00 2001 From: Robert Speicher Date: Thu, 24 Sep 2015 12:55:00 -0400 Subject: [PATCH 3/3] Update Troubleshooting sections --- doc/install/installation.md | 8 ++++---- doc/update/7.14-to-8.0.md | 7 ++++--- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/doc/install/installation.md b/doc/install/installation.md index 282c84fd1e1..039bb3c2561 100644 --- a/doc/install/installation.md +++ b/doc/install/installation.md @@ -524,7 +524,7 @@ Apart from the always supported markdown style there are other rich text files t ### "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 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). +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 e25b38a3533..30d1826b473 100644 --- a/doc/update/7.14-to-8.0.md +++ b/doc/update/7.14-to-8.0.md @@ -196,6 +196,7 @@ If you have more than one backup `*.tar` file(s) please add `BACKUP=timestamp_of ### "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 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. +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.