diff --git a/nginx/README.md b/nginx/README.md index e2b24b006..40cd1fe63 100644 --- a/nginx/README.md +++ b/nginx/README.md @@ -65,30 +65,32 @@ Then you can hit `http://localhost:8080` or `http://host-ip:8080` in your browse ## complex configuration ```console -$ docker run --name some-nginx -v /some/nginx.conf:/etc/nginx/nginx.conf:ro -d nginx +$ docker run --name my-custom-nginx-container -v /host/path/nginx.conf:/etc/nginx/nginx.conf:ro -d nginx ``` For information on the syntax of the Nginx configuration files, see [the official documentation](http://nginx.org/en/docs/) (specifically the [Beginner's Guide](http://nginx.org/en/docs/beginners_guide.html#conf_structure)). -Be sure to include `daemon off;` in your custom configuration to ensure that Nginx stays in the foreground so that Docker can track the process properly (otherwise your container will stop immediately after starting)! - If you wish to adapt the default configuration, use something like the following to copy it from a running Nginx container: ```console -$ docker cp some-nginx:/etc/nginx/nginx.conf /some/nginx.conf +$ docker run --name tmp-nginx-container -d nginx +$ docker cp tmp-nginx-container:/etc/nginx/nginx.conf /host/path/nginx.conf +$ docker rm -f tmp-nginx-container ``` -As above, this can also be accomplished more cleanly using a simple `Dockerfile`: +As above, this can also be accomplished more cleanly using a simple `Dockerfile` (in `/host/path/`): ```dockerfile FROM nginx COPY nginx.conf /etc/nginx/nginx.conf ``` -Then, build with `docker build -t some-custom-nginx .` and run: +If you add a custom `CMD` in the Dockerfile, be sure to include `-g daemon off;` to `CMD` that Nginx stays in the foreground so that Docker can track the process properly (otherwise your container will stop immediately after starting)! + +Then, build with `docker build -t custom-nginx .` and run: ```console -$ docker run --name some-nginx -d some-custom-nginx +$ docker run --name my-custom-nginx-container -d custom-nginx ``` ### using environment variables in nginx configuration