Commit ecff897dad60608c35341aaf665769f845048016
1 parent
1f09a78c
Exists in
master
Add the notes about using external webserver to README.
Showing
1 changed file
with
23 additions
and
0 deletions
Show diff stats
README.md
| @@ -333,6 +333,29 @@ external_url "https://gitlab.example.com:2443" | @@ -333,6 +333,29 @@ external_url "https://gitlab.example.com:2443" | ||
| 333 | 333 | ||
| 334 | Run `sudo gitlab-ctl reconfigure` for the change to take effect. | 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 | ### Adding ENV Vars to the Gitlab Runtime Environment | 359 | ### Adding ENV Vars to the Gitlab Runtime Environment |
| 337 | 360 | ||
| 338 | If you need Gitlab to have access to certain environment variables, you can | 361 | If you need Gitlab to have access to certain environment variables, you can |