compilenix/nginx repository overview

⁠What is this?

A set of smol Nginx⁠ container images, built from source (using fedora) into a FROM scratch container image.

The primary motivations for this container image are:

• up-to-date libraries and build-tools
• frequently used and popular 3rd party modules built-in
• smaller image size
• ability for custom source code patches⁠
• multiple image variants, to balance between size and features

⁠Key Features

• OpenSSL 3.5⁠
• kTLS supported and enabled by default
• Nginx NJS Module
• Nginx Perl Module
• OpenResty's headers-more-nginx-module⁠
• NGINX-based Media Streaming Server (nginx-rtmp-module)⁠
• Google's brotli compression⁠
• Nginx module for the Zstandard compression⁠
• Most optional / non-default nginx modules built-in
• sh & envsubst entrypoints for nginx config processing on container startup

⁠Project Links

• Container Image Registry⁠
• Git Repository⁠
• Project issues⁠
• Git Mirror 1⁠
• Git Mirror 2⁠

⁠Supported Container Image Tags

• <version>, 1.29, 1, latest
• <version>-extras, 1.29-extras, 1-extras, latest-extras
• <version>-slim, 1.29-slim, 1-slim, latest-slim

⁠Container Image Variants

⁠Default (<version>, 1.29, 1, latest)

This container image has all features and modules built-in that will suit most regular use-cases, while maintaining a low image size.

The following notable features are available:

• --with-compat, so you can dynamically load your own nginx modules on startup
• --with-debug, which enables you to use debug_connection
• --with-http_gzip_static_module
• --with-http_realip_module
• --with-http_stub_status_module
• --with-http_v2_module
• --with-http_v3_module
• --with-pcre-jit
• --with-stream
• --with-stream_realip_module
• Nginx NJS Module
• Google's brotli compression⁠
• OpenResty's headers-more-nginx-module⁠
• NGINX-based Media Streaming Server (nginx-rtmp-module)⁠
• Nginx module for the Zstandard compression⁠
• OpenSSL 3.5⁠
• sh & envsubst entrypoints for nginx config processing on container startup

The following nginx modules are NOT available:

• --without-http_empty_gif_module
• --without-http_geo_module
• --without-http_grpc_module
• --without-http_memcached_module
• --without-http_mirror_module
• --without-http_scgi_module
• --without-http_ssi_module
• --without-http_uwsgi_module
• --without-mail_imap_module
• --without-mail_pop3_module
• --without-mail_smtp_module
• --without-stream_geo_module

⁠Extras (<version>-extras, 1.29-extras, 1-extras, latest-extras)

This container image has all features and modules built-in, without the focus on low image size.

The following notable features are available:

• Everything that is also part of the Default image variant
• Nginx Perl Module
• --with-http_dav_module
• --with-http_gunzip_module
• --with-http_image_filter_module
• --with-http_random_index_module
• --with-http_secure_link_module
• --with-http_slice_module
• --with-http_xslt_module
• --with-mail
• --with-stream_geoip_module

⁠Slim (<version>-slim, 1.29-slim, 1-slim, latest-slim)

This container image has most features and modules built-in, with a focus on the least amount of non-upstream dependencies, modules and overall small image size.

OpenResty's headers-more-nginx-module⁠ is the only non-upstream module built-in.

The following nginx modules are NOT available:

• Nginx NJS Module
• Google's brotli compression⁠
• NGINX-based Media Streaming Server (nginx-rtmp-module)⁠
• Nginx module for the Zstandard compression⁠

⁠Full Documentation

Readme⁠