While it is recommended to install GitLab in its own (sub)domain, sometimes
While it is recommended to install GitLab on its own (sub)domain, sometimes
this is not possible due to a variety of reasons. In that case, GitLab can also
this is not possible due to a variety of reasons. In that case, GitLab can also
be installed under a relative URL, for example `https://example.com/gitlab`.
be installed under a relative URL, for example `https://example.com/gitlab`.
There is no limit as to how much deeply nested the relative URL can be. For
There is no limit to how deeply nested the relative URL can be. For example you
example you could serve GitLab under `/foo/bar/gitlab/git` without any issues.
could serve GitLab under `/foo/bar/gitlab/git` without any issues.
Note that by changing the URL on an existing GitLab installation, all remote
Note that by changing the URL on an existing GitLab installation, all remote
URLS will change, so you'll have to manually edit them in any local repository
URLs will change, so you'll have to manually edit them in any local repository
that points to your GitLab instance.
that points to your GitLab instance.
---
---
...
@@ -47,8 +47,7 @@ See the [requirements](requirements.md) document for more information.
...
@@ -47,8 +47,7 @@ See the [requirements](requirements.md) document for more information.
_**Note:**
_**Note:**
Do not make any changes to your web server configuration file regarding
Do not make any changes to your web server configuration file regarding
relative URL. The relative URL support is basically implemented by GitLab
relative URL. The relative URL support is implemented by GitLab Workhorse._
Workhorse._
---
---
...
@@ -109,7 +108,7 @@ Make sure to follow all steps below:
...
@@ -109,7 +108,7 @@ Make sure to follow all steps below:
gitlab-workhorse setting as needed.
gitlab-workhorse setting as needed.
1. After all the above changes recompile the assets. This is an important task
1. After all the above changes recompile the assets. This is an important task
and will take some time to complete depending on the server resources.
and will take some time to complete depending on the server resources:
```
```
cd /home/git/gitlab
cd /home/git/gitlab
...
@@ -121,7 +120,7 @@ Make sure to follow all steps below:
...
@@ -121,7 +120,7 @@ Make sure to follow all steps below:
### Disable relative URL in GitLab
### Disable relative URL in GitLab
To disable the relative URL, follow the same steps as above and set up the
To disable the relative URL, follow the same steps as above and set up the
GitLab URL to a one that doesn't contain a relative path.
GitLab URL to one that doesn't contain a relative path.
[omnibus-rel]:http://doc.gitlab.com/omnibus/settings/configuration.html#configuring-a-relative-url-for-gitlab"How to setup relative URL in Omnibus GitLab"
[omnibus-rel]:http://doc.gitlab.com/omnibus/settings/configuration.html#configuring-a-relative-url-for-gitlab"How to setup relative URL in Omnibus GitLab"
[restart gitlab]:../administration/restart_gitlab.md#installations-from-source"How to restart GitLab"
[restart gitlab]:../administration/restart_gitlab.md#installations-from-source"How to restart GitLab"