honeok/freenginx repository overview

⁠freenginx

freenginx is an effort to preserve free and open development of nginx [engine x], an HTTP and reverse proxy server, a mail proxy server, and a generic TCP/UDP proxy server, originally written by Igor Sysoev⁠.

The sources and documentation are distributed under the 2-clause BSD-like license⁠.

⁠Introduction

• Built from FreeNginx source based on the Alpine build configuration from the official NGINX packaging sources.
• All images are built exclusively on Alpine Linux; no other base distributions are provided.
• Keeps the final image small by removing build dependencies and unnecessary files after compilation.
• Keeps the filesystem layout and configuration paths aligned with the official NGINX Alpine image.
• Includes Brotli, Zstandard, and Headers More as built-in modules, along with other commonly used third-party functionality as dynamically loadable modules.

⁠Quick Start

docker run -d --name freenginx -p 80:80 honeok/freenginx:alpine

⁠Dynamic modules

Bundled dynamic modules are installed in /usr/lib/nginx/modules, with /etc/nginx/modules linked to the same location, following the layout of the official NGINX Alpine image.

To enable a bundled dynamic module, edit the NGINX configuration file:

vim /etc/nginx/nginx.conf

load_module modules/<module>.so;

For configuration details, see the official documentation⁠.

⁠Acknowledgements

Special thanks to Maxim Dounin⁠ for his long-standing contributions to NGINX and for creating and maintaining FreeNginx⁠.

Thanks to the maintainers of the third-party modules included in this image.

This is an independent, unofficial build and is not affiliated with or endorsed by Maxim Dounin⁠ or the FreeNginx project.