nginx docker base image which can use environment variables in nginx config files
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 4 commits ahead of chadoe:master.
Latest commit b432166 Jun 6, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
conf Updating dockerfile Jun 6, 2018
Dockerfile Updating dockerfile Jun 6, 2018
LICENSE Initial commit Jun 6, 2015 Updating docs Jun 6, 2018 exec nginx so it is PID 1 and we can stop it properly. Jul 26, 2015


This Docker image is designed to use Docker environmental variables with NGinx configuration files. For more information on why I created this fork, check out the companion blog post on

Using with the Default vhosts.conf file

Default usage with a php-fpm container requires no custom configuration.

  1. Start your PHP container: docker run --name php-fpm-api -v $(pwd):/var/www php:fpm
  2. Start this NGinx container: docker run --link php-fpm-api -e NGINX_HOST=php-fpm-api shiphp/nginx-env

Custom usage

  1. Create a new Dockerfile and add your config files
FROM shiphp/nginx-env

  1. Place nginx site config file in directory ./conf, these will be placed in /etc/nginx/conf.d/
  2. docker build -t mynew/nginx .
  3. docker run -d mynew/nginx

Config files may contain environment variables in the form of $ENV{"environmentvariablename"}. These will be replaced when the container starts.