Add the notes about using external webserver to README.

Marin Jankovski
1 parent 1f09a78c
Showing 1 changed file with 23 additions and 0 deletions Show diff stats
README.md
@@ -333,6 +333,29 @@ external_url &quot;https://gitlab.example.com:2443&quot;
  
 Run `sudo gitlab-ctl reconfigure` for the change to take effect.
  
+#### Use non-bundled web-server
+
+By default, omnibus-gitlab installs GitLab with bundled Nginx.
+To use another web server like Apache or an existing Nginx installation you will
+have to do the following steps:
+
+Disable bundled Nginx by specifying in `/etc/gitlab/gitlab.rb`:
+
+```ruby
+nginx['enable'] = false
+```
+
+omnibus-gitlab allows webserver access through user `gitlab-www` which resides in the group with the same name.
+To allow an external webserver access to GitLab, you will need to add the webserver user to `gitlab-www` group.
+Let's say that webserver user is `www-data`. Adding the user to `gitlab-www` group can be done with:
+
+```
+usermod -G gitlab-www www-data
+```
+
+Run `sudo gitlab-ctl reconfigure` for the change to take effect.
+
+
 ### Adding ENV Vars to the Gitlab Runtime Environment
  
 If you need Gitlab to have access to certain environment variables, you can
...	...	@@ -333,6 +333,29 @@ external_url "https://gitlab.example.com:2443"
333	333
334	334	Run `sudo gitlab-ctl reconfigure` for the change to take effect.
335	335
	336	+#### Use non-bundled web-server
	337	+
	338	+By default, omnibus-gitlab installs GitLab with bundled Nginx.
	339	+To use another web server like Apache or an existing Nginx installation you will
	340	+have to do the following steps:
	341	+
	342	+Disable bundled Nginx by specifying in `/etc/gitlab/gitlab.rb`:
	343	+
	344	+```ruby
	345	+nginx['enable'] = false
	346	+```
	347	+
	348	+omnibus-gitlab allows webserver access through user `gitlab-www` which resides in the group with the same name.
	349	+To allow an external webserver access to GitLab, you will need to add the webserver user to `gitlab-www` group.
	350	+Let's say that webserver user is `www-data`. Adding the user to `gitlab-www` group can be done with:
	351	+
	352	+```
	353	+usermod -G gitlab-www www-data
	354	+```
	355	+
	356	+Run `sudo gitlab-ctl reconfigure` for the change to take effect.
	357	+
	358	+
336	359	### Adding ENV Vars to the Gitlab Runtime Environment
337	360
338	361	If you need Gitlab to have access to certain environment variables, you can
...	...