Image Flavors Overview

The docker-openresty project offers a wide variety of image "flavors" to suit different needs. These flavors are based on various operating systems and can be categorized into two main groups:

  1. Built from Upstream Packages: These images are built using the official pre-compiled packages provided by the OpenResty team. They are the recommended choice for most users as they are stable, well-tested, and easy to use.

  2. Built from Source: These images compile OpenResty and its dependencies from source code during the Docker build process. They offer maximum flexibility and are intended for advanced users who need to customize the build with specific modules or configuration options.

Choosing a Flavor

  • For Production & General Use: Start with an upstream package flavor. The bookworm or bullseye (Debian-based) images are excellent, stable choices. alpine-apk is ideal if you need a minimal image size.

  • For Customization: If you need to add custom Nginx modules (that are not available as dynamic modules), apply patches, or change compile-time options, use a build-from-source flavor. The alpine or jammy images are good starting points.

This section provides details on all available flavors.