Skip to content

nginx_proxy: Provide option to add configuration parameters to root level of generated nginx conf #4629

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
emcauliffe wants to merge 4 commits into
base: master
Choose a base branch
from
+11 −1
Open

nginx_proxy: Provide option to add configuration parameters to root level of generated nginx conf #4629

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
29a8e11
Add root_blocks configuration to nginx_proxy
emcauliffe May 25, 2026
b38cd87
add customization at the root level of the generated nginx file
emcauliffe May 25, 2026
61508f7
resolve doc term mismatch
emcauliffe May 25, 2026
ee58d76
update schema with root_conf
emcauliffe May 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion nginx_proxy/DOCS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ Value for the [`Strict-Transport-Security`][hsts] HTTP header to send. If empty,

### Option `customize.active` (required)

If true, additional NGINX configuration files for the default server and additional servers are read from files in the `/share` directory specified by the `default` and `servers` variables.
If true, additional NGINX configuration files for the default server and additional servers are read from files in the `/share` directory specified by the `default`, `servers`, and `root_conf` variables.
Comment thread
emcauliffe marked this conversation as resolved.

### Option `customize.default` (required)

Expand All @@ -74,6 +74,10 @@ The filename of the NGINX configuration for the default server, found in the `/s

The filename(s) of the NGINX configuration for the additional servers, found in the `/share` directory.

### Option `customize.root_conf` (required)

The filename of the NGINX configuration for additional parameters to place in the root level of the configuration file, found in the `/share` directory.

### Option `cloudflare` (optional)

If enabled, configure Nginx with a list of IP addresses directly from Cloudflare that will be used for `set_real_ip_from` directive Nginx config.
Expand Down
2 changes: 2 additions & 0 deletions nginx_proxy/config.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ options:
active: false
default: nginx_proxy_default*.conf
servers: nginx_proxy/*.conf
root_conf: nginx_root_conf*.conf
Comment thread
coderabbitai[bot] marked this conversation as resolved.
real_ip_from: []
ports:
443/tcp: 443
Expand All @@ -40,5 +41,6 @@ schema:
active: bool
default: str
servers: str
root_conf: str
real_ip_from:
- str
4 changes: 4 additions & 0 deletions nginx_proxy/rootfs/etc/nginx/nginx.conf.gtpl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ events {
worker_connections 1024;
}

{{- if .options.customize.active }}
include /share/{{ .options.customize.root_conf }};
{{- end }}

http {
map_hash_bucket_size 128;

Expand Down