honeok/openresty repository overview

⁠OpenResty

OpenResty⁠® is a full-fledged web platform that integrates an enhanced version of the Nginx core, an enhanced version of LuaJIT⁠, many carefully written Lua libraries, lots of high-quality 3rd-party Nginx modules, and most of their external dependencies. It is designed to help developers easily build scalable web applications, web services, and dynamic web gateways.

Maintained by honeok⁠. Source code is available at honeok/docker-nginxkit⁠.

⁠Introduction

• Built from source based on the build configuration used by the official OpenResty Alpine image.
• 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.
• Includes Brotli, Zstandard, and other commonly used third-party modules as dynamically loadable modules.

⁠Quick Start

⁠stable

Built from official OpenResty sources.

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

⁠edge

Built from the OpenResty sources maintained by teddysun⁠, combining the OpenResty ecosystem with the latest NGINX core.

docker run -d --name openresty -p 80:80 honeok/openresty:alpine-edge

⁠Dynamic modules

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

vim /usr/local/openresty/nginx/conf/nginx.conf

load_module modules/<module>.so;

Check the module files in /usr/local/openresty/nginx/modules and load only the ones you need. For configuration details, see the official documentation⁠.

⁠Acknowledgements

Thanks to Yichun Zhang⁠ (agentzh), the OpenResty team, teddysun⁠, and 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 OpenResty Inc.⁠ or the OpenResty project.

OpenResty® is a registered trademark owned by OpenResty Inc.⁠.