Alpine Linux Nginx

A lightweight Nginx Docker image built from source atop Alpine Linux. Available on GitHub.

Mainline 1.11.x Branch Tags

Nginx 1.11.8+ are built on Alpine Linux 3.5.0 (LibreSSL 2.4.4, gcc 6.2.1).

• 1.11.10, 1.11, mainline, latest (2017-02-14, Dockerfile, Changes)
• 1.11.9 (2017-01-24)
• 1.11.8 (2016-12-27)
• 1.11.7 (2016-12-13)
• 1.11.6 (2016-11-15)
• 1.11.5 (2016-10-11)
• 1.11.4 (2016-09-13)
• 1.11.3 (2016-07-26)
• 1.11.2 (2016-07-05)
• 1.11.1 (2016-05-31)
• 1.11.0 (2016-05-24)

Stable 1.10.x Branch Tags

Nginx 1.10.2+ are built on Alpine Linux 3.5.0 (LibreSSL 2.4.4, gcc 6.2.1).

• 1.10.3, 1.10, stable (2017-01-31, Dockerfile, Changes)
• 1.10.2 (2016-10-18)
• 1.10.1 (2016-05-31)
• 1.10.0 (2016-04-26)

Legacy 1.8.x Branch Tags

• 1.8.1, 1.8, legacy (2016-01-26, Dockerfile, Changes)

Kubernetes <1.2.0

Tags with the -k8s suffix are built on Alpine-Kubernetes 3.3, an image for Kubernetes and other Docker cluster environments that use DNS-based service discovery. It adds the necessary search domain support for DNS resolution. If you're running Kubernetes 1.2.0 or later on all your cluster nodes, you should now use the non-k8s tags. Modern Kubernetes defaults to dnsPolicy=ClusterFirst in pod specs, and defines a single nameserver in /etc/resolv.conf. This means things should finally work correctly for Alpine Linux images without modification.

• 1.11.1-k8s, 1.11-k8s, mainline-k8s, latest-k8s
• 1.11.0-k8s
• 1.10.1-k8s, 1.10-k8s, stable-k8s
• 1.10.0-k8s
• 1.8.1-k8s, 1.8-k8s, legacy-k8s

Default Usage

$ docker run --rm sickp/alpine-nginx:1.11.10
2017/02/15 03:41:24 [notice] 1#1: using the "epoll" event method
2017/02/15 03:41:24 [notice] 1#1: nginx/1.11.10
2017/02/15 03:41:24 [notice] 1#1: built by gcc 6.2.1 20160822 (Alpine 6.2.1)
2017/02/15 03:41:24 [notice] 1#1: OS: Linux 4.9.8-moby
2017/02/15 03:41:24 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576
2017/02/15 03:41:24 [notice] 1#1: start worker processes
2017/02/15 03:41:24 [notice] 1#1: start worker process 7

Configuration

Nginx is compiled from source using the same configure arguments as the official, pre-built packages.

$ docker run --rm sickp/alpine-nginx:1.11.10 nginx -V
nginx version: nginx/1.11.10
built by gcc 6.2.1 20160822 (Alpine 6.2.1)
built with LibreSSL 2.4.4
TLS SNI support enabled
configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --user=nginx --group=nginx --with-http_ssl_module --with-http_realip_module --with-http_addition_module --with-http_sub_module --with-http_dav_module --with-http_flv_module --with-http_mp4_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_random_index_module --with-http_secure_link_module --with-http_stub_status_module --with-http_auth_request_module --with-threads --with-stream --with-stream_ssl_module --with-http_slice_module --with-mail --with-mail_ssl_module --with-file-aio --with-http_v2_module --with-ipv6 --with-stream_realip_module

$ docker run --rm sickp/alpine-nginx:1.11.10 cat /etc/alpine-release
3.5.0

History

• 2017-02-14 - Updated to Nginx 1.11.10. <3 sickp
• 2017-01-31 - Updated stable branch to Nginx 1.10.3.
• 2017-01-24 - Updated to Nginx 1.11.9. Rebuilt Nginx 1.10.2 with Alpine Linux 3.5.0.
• 2016-12-28 - Rebuilt 1.11.8 mainline with --with-stream_realip_module.
• 2016-12-28 - Updated to Nginx 1.11.8 and Alpine Linux 3.5.0 (LibreSSL 2.4.4, gcc 6.2.1).
• 2016-12-14 - Updated to Nginx 1.11.7.
• 2016-11-16 - Updated to Nginx 1.11.6 (Alpine Linux 3.4.4).
• 2016-10-18 - Added Nginx 1.10.2 (OpenSSL 1.0.2j, Alpine Linux 3.4.4).
• 2016-10-11 - Updated to Nginx 1.11.5 (OpenSSL 1.0.2j, Alpine Linux 3.4.3).
• 2016-09-13 - Updated to Nginx 1.11.4.
• 2016-07-26 - Updated to Nginx 1.11.3.
• 2016-07-11 - Updated to Nginx 1.11.2.
• 2016-06-15 - Updated 1.11.x, 1.10.x, 1.8.x to Alpine Linux 3.4.0 (with search support for Kubernetes >=1.2.0).
• 2016-06-01 - Updated to Nginx 1.11.1 (mainline) and Nginx 1.10.1 (stable).
• 2016-05-25 - Added new mainline branch Nginx 1.11.0, OpenSSL 1.0.2h.
• 2016-04-26 - Added new stable branch Nginx 1.10.0. Moved old stable to legacy branch. Added more -k8s tags.
• 2016-04-21 - Updated to Nginx 1.9.15.
• 2016-04-05 - Updated to Nginx 1.9.14, Alpine Linux 3.3.3. Added stable branch Nginx 1.8.1.
• 2016-03-30 - Updated to Nginx 1.9.13, OpenSSL 1.0.2g.
• 2016-02-24 - Updated to Nginx 1.9.12.
• 2016-02-09 - Updated to Nginx 1.9.11 (and added http_slice_module).
• 2016-02-09 - Updated to OpenSSL 1.0.2f. Added support for ALPINE_NO_RESOLVER in 1.9.10-k8s.
• 2016-01-27 - Added Kubernetes versions (-k8s), until Alpine Linux/musl adds DNS search support.
• 2016-01-26 - Updated to Nginx 1.9.10, Alpine Linux 3.3.1.
• 2015-12-24 - Updated 1.9.9 image to Alpine Linux 3.3 (gcc 5.3.0, OpenSSL 1.0.2e).
• 2015-12-10 - Updated to 1.9.9.
• 2015-11-27 - Initial version.