Duplicate vhost block Nginx (non-bundled example), confusing
Hi,
In the following markdown file, there is vhost server block Nginx example: https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/settings/nginx.md#vhost-server-block
However, at step 5 at 'Using a non bundled webserver', you are referring to this gitlab-recipes
respository:
https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/settings/nginx.md#using-a-non-bundled-web-server
So it's conflicting in the same markdown file. I think it's a good idea to remove the Vhost example in omnibus gitlab repo. And only refer to this separate repo.
Kind regards, Melroy van den berg
Implementation Guide
Edit https://docs.gitlab.com/omnibus/settings/nginx.html#using-an-existing-passengernginx-installation to read like:
## Using an existing NGINX installation
In some cases you may want to host GitLab using an existing Passenger/NGINX
installation but still have the convenience of updating and installing using
the omnibus packages.
NOTE:
When disabling NGINX, you won't be able to access
other services included by Omnibus, like Grafana, Mattermost, etc. unless
you manually add them in `nginx.conf`.
1. First, you'll need to setup your `/etc/gitlab/gitlab.rb` to disable the built-in
NGINX and Puma:
```ruby
# Define the external url
external_url 'http://git.example.com'
# Disable the built-in nginx
nginx['enable'] = false
# Disable the built-in puma
puma['enable'] = false
# Set the internal API URL
gitlab_rails['internal_api_url'] = 'http://git.example.com'
# Define the web server process user (ubuntu/nginx)
web_server['external_users'] = ['www-data']
```
1. Reconfigure GitLab:
```shell
sudo gitlab-ctl reconfigure
```
1. Consult the [NGINX templates](https://gitlab.com/gitlab-org/gitlab-foss/-/tree/master/lib/support/nginx) and make the appropriate changes to your NGINX config files.
Edited by Achilleas Pipinellis