Skip to content

Commit be83b9b

Browse files
authored
fix: config path in managing-config-files (#1143)
1 parent 3262440 commit be83b9b

File tree

1 file changed

+32
-9
lines changed

1 file changed

+32
-9
lines changed

content/nginx/admin-guide/basic-functionality/managing-configuration-files.md

Lines changed: 32 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,33 @@ type:
99
- how-to
1010
---
1111

12-
Similar to other services, NGINX and NGINX Plus use a text‑based configuration file with a precise format. By default the file is named **nginx.conf** and for NGINX Plus is placed in the `/etc/nginx` directory.
12+
NGINX and NGINX Plus use a text‑based configuration file, by default named **nginx.conf**.
1313

14-
For NGINX Open Source, the location depends on the package system used to install NGINX and the operating system. It is typically one of `/usr/local/nginx/conf`, `/etc/nginx`, or `/usr/local/etc/nginx`.
14+
NGINX Plus: default location is `/etc/nginx` for Linux or `/usr/local/etc/nginx` for FreeBSD.
15+
16+
NGINX Open Source: location depends on the package system used to install NGINX and the operating system. It is typically one of `/usr/local/nginx/conf`, `/etc/nginx`, or `/usr/local/etc/nginx`.
17+
18+
You can verify the exact configuration file path with the `--conf-path=` parameter in the output of the `nginx -V` command:
19+
20+
```shell
21+
nginx -V 2>&1 | awk -F: '/configure arguments/ {print $2}' | xargs -n1
22+
```
23+
24+
Sample output:
25+
26+
```none
27+
--prefix=/etc/nginx
28+
--sbin-path=/usr/sbin/nginx
29+
--modules-path=/usr/lib64/nginx/modules
30+
--conf-path=/etc/nginx/nginx.conf # The path to your config file
31+
--error-log-path=/var/log/nginx/error.log
32+
--http-log-path=/var/log/nginx/access.log
33+
--pid-path=/var/run/nginx.pid
34+
--...<more parameters>
35+
```
1536

1637
## Directives
38+
1739
The configuration file consists of _directives_ and their parameters. Simple (single‑line) directives end with a semicolon ( `;` ). Other directives act as “containers” which group together related directives. Containers are enclosed in curly braces ( `{}` ) and are often referred to as _blocks_. Here are some examples of simple directives.
1840

1941
```nginx
@@ -22,9 +44,9 @@ error_log logs/error.log notice;
2244
worker_processes 1;
2345
```
2446

25-
## Feature-Specific Configuration Files
47+
## Feature-specific configuration files
2648

27-
To make the configuration easier to maintain, we recommend that you split it into a set of feature‑specific files stored in the <span style="white-space: nowrap;">**/etc/nginx/conf.d**</span> directory and use the [include](https://nginx.org/en/docs/ngx_core_module.html#include) directive in the main **nginx.conf** file to reference the contents of the feature‑specific files.
49+
To make the configuration easier to maintain, it is possible to split it into a set of feature‑specific files stored in the `/etc/nginx/conf.d` directory and use the [include](https://nginx.org/en/docs/ngx_core_module.html#include) directive in the main **nginx.conf** file to reference the contents of the feature‑specific files.
2850

2951
```nginx
3052
include conf.d/http;
@@ -43,14 +65,15 @@ A few top‑level directives, referred to as _contexts_, group together the dire
4365

4466
Directives placed outside of these contexts are said to be in the _main_ context.
4567

46-
### Virtual Servers
68+
### Virtual servers
69+
4770
In each of the traffic‑handling contexts, you include one or more `server` blocks to define _virtual servers_ that control the processing of requests. The directives you can include within a `server` context vary depending on the traffic type.
4871

4972
For HTTP traffic (the `http` context), each [server](https://nginx.org/en/docs/http/ngx_http_core_module.html#server) directive controls the processing of requests for resources at particular domains or IP addresses. One or more [location](https://nginx.org/en/docs/http/ngx_http_core_module.html#location) contexts within a `server` context define how to process specific sets of URIs.
5073

5174
For mail and TCP/UDP traffic (the [mail](https://nginx.org/en/docs/mail/ngx_mail_core_module.html) and [stream](https://nginx.org/en/docs/stream/ngx_stream_core_module.html) contexts) the `server` directives each control the processing of traffic arriving at a particular TCP port or UNIX socket.
5275

53-
### Sample Configuration File with Multiple Contexts
76+
### Sample configuration file with multiple contexts
5477

5578
The following configuration illustrates the use of contexts.
5679

@@ -89,10 +112,10 @@ stream {
89112

90113
### Inheritance
91114

92-
In general, a _child_ context – a context contained within another context (its _parent_) – inherits the settings of directives included at the parent level. Some directives can appear in multiple contexts, in which case you can override the setting inherited from the parent by including the directive in the child context. For an example, see the [proxy_set_header](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_set_header) directive.
115+
In general, a _child_ context – a context contained within another context (its _parent_) – inherits the settings of directives included at the parent level. Some directives can appear in multiple contexts, in which case you can override the setting inherited from the parent by including the directive in the child context. For an example, see the [proxy_set_header](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_set_header) directive.
93116

94-
## Reload Configuration File
117+
## Reload configuration file
95118

96119
For changes to the configuration file to take effect, it must be reloaded. You can either restart the `nginx` process or send the `reload` signal to upgrade the configuration without interrupting the processing of current requests. For details, see [Control NGINX Processes at Runtime]({{< ref "/nginx/admin-guide/basic-functionality/runtime-control.md" >}}).
97120

98-
With NGINX Plus, you can dynamically reconfigure [load balancing]({{< ref "/nginx/admin-guide/load-balancer/dynamic-configuration-api.md" >}}) across the servers in an upstream group without reloading the configuration. You can also use the NGINX Plus API and key‑value store to dynamically control access, for example [based on client IP address]({{< ref "/nginx/admin-guide/security-controls/denylisting-ip-addresses.md" >}}).
121+
With NGINX Plus, you can dynamically reconfigure [load balancing]({{< ref "/nginx/admin-guide/load-balancer/dynamic-configuration-api.md" >}}) across the servers in an upstream group without reloading the configuration. You can also use the NGINX Plus API and key‑value store to dynamically control access, for example [based on client IP address]({{< ref "/nginx/admin-guide/security-controls/denylisting-ip-addresses.md" >}}).

0 commit comments

Comments
 (0)