How can I use environment variables in Nginx.conf

From the official Nginx docker file:

Using environment variables in nginx configuration:

Out-of-the-box, Nginx doesn’t support using environment variables
inside most configuration blocks.

But envsubst may be used as a
workaround if you need to generate your nginx configuration
dynamically before nginx starts.

Here is an example using docker-compose.yml:

image: nginx
 - ./mysite.template:/etc/nginx/conf.d/mysite.template
 - "8080:80"
command: /bin/bash -c "envsubst < /etc/nginx/conf.d/mysite.template > /etc/nginx/conf.d/default.conf && nginx -g 'daemon off;'" 

The mysite.template file may then contain variable references like
this :

listen ${NGINX_PORT};


But you know this caused to its Nginx variables like this:

proxy_set_header        X-Forwarded-Host $host;

damaged to:

proxy_set_header        X-Forwarded-Host ;

So, to prevent that, i use this trick:

I have a script to run Nginx, that used on the docker-compose file as command option for Nginx server, i named it

#!/usr/bin/env bash
export DOLLAR='$'
envsubst < nginx.conf.template > /etc/nginx/nginx.conf
nginx -g "daemon off;"

And because of defined new DOLLAR variable on script, now content of my nginx.conf.template file for Nginx itself variable is like this:

proxy_set_header        X-Forwarded-Host ${DOLLAR}host;

And for my defined variable is like this:

server_name  ${WEB_DOMAIN} www.${WEB_DOMAIN};

Also here, there is my real use case for that.

Leave a Comment