From b9cb1b740355b4371e22e05a6ebd9da6b5f8b125 Mon Sep 17 00:00:00 2001
From: Etki <etki@etki.me>
Date: Mon, 3 Apr 2017 09:13:22 +0300
Subject: [PATCH] Added information about running nginx in debug mode
 https://github.com/nginxinc/docker-nginx/issues/55

---
 nginx/content.md | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/nginx/content.md b/nginx/content.md
index a333e0d7d..d1a7a9e2f 100644
--- a/nginx/content.md
+++ b/nginx/content.md
@@ -72,7 +72,8 @@ Out-of-the-box, Nginx doesn't support using environment variables inside most co
 
 Here is an example using docker-compose.yml:
 
-```web:
+```
+web:
   image: nginx
   volumes:
    - ./mysite.template:/etc/nginx/conf.d/mysite.template
@@ -84,7 +85,27 @@ Here is an example using docker-compose.yml:
   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 :
+The `mysite.template` file may then contain variable references like this:
 
 `listen       ${NGINX_PORT};
 `
+
+## running nginx in debug mode
+ 
+Images since version 1.9.8 come with `nginx-debug` binary that produces
+complete output when using higher verbosity log levels. It can be used 
+with simple CMD substitution:
+
+```console
+docker run --name my-nginx -v /host/path/nginx.conf:/etc/nginx/nginx.conf:ro -d nginx nginx-debug -g 'daemon off;'
+```
+
+Similar configuration in docker-compose.yml may look like this:
+
+```
+web:
+  image: nginx
+  volumes:
+    - ./nginx.conf:/etc/nginx/nginx.conf:ro
+  command: [nginx-debug, '-g', 'daemon off;']
+```