diff --git a/doc/settings/configuration.md b/doc/settings/configuration.md index 0dda40c16a8d43ae0bd16d7d6a6e523e7d495968_ZG9jL3NldHRpbmdzL2NvbmZpZ3VyYXRpb24ubWQ=..8063b8ce9b03857d7682197156ddce30f75be9bb_ZG9jL3NldHRpbmdzL2NvbmZpZ3VyYXRpb24ubWQ= 100644 --- a/doc/settings/configuration.md +++ b/doc/settings/configuration.md @@ -6,7 +6,7 @@ New installations starting from GitLab 7.6, will have all the options of the template listed in `/etc/gitlab/gitlab.rb` by default. -### Configuring the external URL for GitLab +## Configuring the external URL for GitLab In order for GitLab to display correct repository clone links to your users it needs to know the URL under which it is reached by your users, e.g. @@ -19,7 +19,7 @@ Run `sudo gitlab-ctl reconfigure` for the change to take effect. -### Loading external configuration file from non-root user +## Loading external configuration file from non-root user Omnibus-gitlab package loads all configuration from `/etc/gitlab/gitlab.rb` file. This file has strict file permissions and is owned by the `root` user. The reason for strict permissions @@ -37,7 +37,7 @@ Please note that code you include into `/etc/gitlab/gitlab.rb` using `from_file` will run with `root` privileges when you run `sudo gitlab-ctl reconfigure`. Any configuration that is set in `/etc/gitlab/gitlab.rb` after `from_file` is included will take precedence over the configuration from the included file. -### Storing Git data in an alternative directory +## Storing Git data in an alternative directory By default, omnibus-gitlab stores the Git repository data under `/var/opt/gitlab/git-data`. The repositories are stored in a subfolder @@ -76,7 +76,7 @@ sudo gitlab-ctl start ``` -### Changing the name of the Git user / group +## Changing the name of the Git user / group By default, omnibus-gitLab uses the user name `git` for Git gitlab-shell login, ownership of the Git data itself, and SSH URL generation on the web interface. @@ -95,7 +95,7 @@ Note that if you are changing the username of an existing installation, the reconfigure run won't change the ownership of the nested directories so you will have to do that manually. Make sure that the new user can access `repositories` as well as the `uploads` directory. -### Specify numeric user and group identifiers +## Specify numeric user and group identifiers omnibus-gitlab creates users for GitLab, PostgreSQL, Redis and NGINX. You can specify the numeric identifiers for these users in `/etc/gitlab/gitlab.rb` as @@ -114,7 +114,7 @@ Run `sudo gitlab-ctl reconfigure` for the changes to take effect. -### Disable user and group account management +## Disable user and group account management By default, omnibus-gitlab takes care of user and group accounts creation as well as keeping the accounts information updated. This behaviour makes sense for most users but in certain environments user and group accounts are managed by other software, eg. LDAP. @@ -210,7 +210,7 @@ Run `sudo gitlab-ctl reconfigure` for the change to take effect. -### Setting up LDAP sign-in +## Setting up LDAP sign-in See [doc/settings/ldap.md](ldap.md). @@ -214,7 +214,7 @@ See [doc/settings/ldap.md](ldap.md). -### Enable HTTPS +## Enable HTTPS See [doc/settings/nginx.md](nginx.md#enable-https). @@ -218,7 +218,7 @@ See [doc/settings/nginx.md](nginx.md#enable-https). -#### Redirect `HTTP` requests to `HTTPS`. +### Redirect `HTTP` requests to `HTTPS`. See [doc/settings/nginx.md](nginx.md#redirect-http-requests-to-https). @@ -222,8 +222,8 @@ See [doc/settings/nginx.md](nginx.md#redirect-http-requests-to-https). -#### Change the default port and the ssl certificate locations. +### Change the default port and the ssl certificate locations. See [doc/settings/nginx.md](nginx.md#change-the-default-port-and-the-ssl-certificate-locations). @@ -226,8 +226,8 @@ See [doc/settings/nginx.md](nginx.md#change-the-default-port-and-the-ssl-certificate-locations). -### Use non-packaged web-server +## Use non-packaged web-server For using an existing Nginx, Passenger, or Apache webserver see [doc/settings/nginx.md](nginx.md#using-a-non-bundled-web-server). @@ -239,8 +239,8 @@ See [doc/settings/redis.md](redis.md). -### Adding ENV Vars to the GitLab Runtime Environment +## Adding ENV Vars to the GitLab Runtime Environment See [doc/settings/environment-variables.md](environment-variables.md). @@ -243,8 +243,8 @@ See [doc/settings/environment-variables.md](environment-variables.md). -### Changing GitLab.yml settings +## Changing GitLab.yml settings See [doc/settings/gitlab.yml.md](gitlab.yml.md). @@ -248,7 +248,7 @@ See [doc/settings/gitlab.yml.md](gitlab.yml.md). -### Sending application email via SMTP +## Sending application email via SMTP See [doc/settings/smtp.md](smtp.md). @@ -252,8 +252,8 @@ See [doc/settings/smtp.md](smtp.md). -### Omniauth (Google, Twitter, GitHub login) +## Omniauth (Google, Twitter, GitHub login) Omniauth configuration is documented in [doc.gitlab.com](http://doc.gitlab.com/ce/integration/omniauth.html). @@ -256,8 +256,8 @@ Omniauth configuration is documented in [doc.gitlab.com](http://doc.gitlab.com/ce/integration/omniauth.html). -### Adjusting Unicorn settings +## Adjusting Unicorn settings See [doc/settings/unicorn.md](unicorn.md). @@ -261,7 +261,7 @@ See [doc/settings/unicorn.md](unicorn.md). -### Setting the NGINX listen address or addresses +## Setting the NGINX listen address or addresses See [doc/settings/nginx.md](nginx.md). @@ -265,7 +265,7 @@ See [doc/settings/nginx.md](nginx.md). -### Inserting custom NGINX settings into the GitLab server block +## Inserting custom NGINX settings into the GitLab server block See [doc/settings/nginx.md](nginx.md). @@ -269,6 +269,6 @@ See [doc/settings/nginx.md](nginx.md). -### Inserting custom settings into the NGINX config +## Inserting custom settings into the NGINX config See [doc/settings/nginx.md](nginx.md).