bcgdv/alpine-nginx repository overview

⁠alpine-nginx

A Docker image for running [nginx][nginx], based on Alpine Linux. This image belongs to a suite of images [documented here][dockeralpine].

⁠Features

This image features:

• Alpine Linux⁠
• s6⁠ and s6-overlay⁠
• [Nginx][nginx]
• [Nginx Dynamic Upstream][nginxupstreammodule]

⁠Usage

To use this image include FROM bcgdv/alpine-nginx at the top of your Dockerfile, or simply docker run -p 8000:80 --name nginx bcgdv/alpine-nginx.

Nginx logs (access and error logs) aren't automatically streamed to stdout and stderr. To review the logs, you can do one of two things:

Run the following in another terminal window:

docker exec -i nginx tail -f /var/log/nginx/access.log -f /var/log/nginx/error.log

or, in your Dockerfile symlink the Nginx logs to stdout and stderr:

RUN ln -sf /dev/stdout /var/log/nginx/access.log && \
    ln -sf /dev/stderr /var/log/nginx/error.log

⁠Customisation

This container comes setup as follows:

• s6 will automatically start nginx for you.
• If nginx dies, so will the container.
• A basic nginx configuration and a simple default HTML file.

⁠HTML content

To alter the HTML content that nginx serves up (add your website files), add the following to your Dockerfile:

ADD /path/to/content /var/www

index.html is the default, but that's easily changed (see below).

⁠Nginx configuration

A basic nginx configuration is supplied with this image. But it's easy to overwrite:

• Create your own default.conf.
• In your Dockerfile, make sure your default.conf file is copied to /etc/nginx/conf.d/default.conf.

Make sure you start nginx without daemon mode, by including daemon off; in your nginx configuration, otherwise the container will constantly exit right after nginx starts.

⁠Restarting nginx

If you're running another process to keep track of something down-stream (for example, automatically updating [nginx][nginx] proxy settings when a down-stream application server (nodejs, php, etc) restarts) execute the command s6-svc -h /var/run/s6/services/nginx to send a SIGHUP to nginx and have it reload its configuration, launch new worker process(es) using this new configuration, while gracefully shutting down the old worker processes.

https://github.com/smebberson/docker-alpine⁠ http://nginx.org/⁠ https://github.com/smebberson/docker-alpine/tree/master/examples/user-nginx⁠ https://github.com/BCGDV/nginx-upstream-dynamic-servers⁠