Image Tags & Pulling
Docker OpenResty images are available on Docker Hub and are mirrored to the GitHub Container Registry.
Tagging Convention
It is a best practice to pin your images to an explicit version tag for predictable and stable builds. The tags follow this convention:
openresty/openresty:<openresty-version>-<image-version>-<flavor>
<openresty-version>: The version of OpenResty (e.g.,1.27.1.2).<image-version>: A revision number for the Docker image itself (e.g.,0).<flavor>: The base OS and build type (e.g.,jammy,alpine-apk,bookworm-fat).
For convenience, a shorter tag omitting the <image-version> is also available for the latest image revision of a specific OpenResty version.
Recommended Image Tags
Here are some common and recommended tags to start with:
| Image Tag | Description |
|---|---|
openresty/openresty:1.27.1.2-0-jammy |
Built-from-source on Ubuntu 22.04 (Jammy) |
openresty/openresty:1.27.1.2-0-focal |
Built-from-source on Ubuntu 20.04 (Focal) |
openresty/openresty:1.27.1.2-0-bookworm |
Built-from-upstream on Debian 12 (Bookworm) |
openresty/openresty:1.27.1.2-0-alpine |
Built-from-source on Alpine Linux |
openresty/openresty:1.27.1.2-0-alpine-apk |
Built-from-upstream on Alpine Linux |
Untagged (Floating) Tags
For development or testing, you can use untagged names, which point to the latest build for a given flavor:
| Image Tag | Description |
|---|---|
openresty/openresty:noble |
Latest Ubuntu 24.04 (Noble) |
openresty/openresty:jammy |
Latest Ubuntu 22.04 (Jammy) |
openresty/openresty:alpine |
Latest Alpine Linux |
Warning: Using floating tags like
latest,alpine, orjammyin production is discouraged, as they can pull in breaking changes unexpectedly.
The latest Tag
The openresty/openresty:latest tag points to the latest bookworm image.
Special Variants
Debug and Valgrind-enabled variants are available for certain flavors, which are useful for development and troubleshooting.
| Image Tag | Description |
|---|---|
openresty/openresty:bullseye-debug |
Bullseye flavor with openresty-debug |
openresty/openresty:bullseye-valgrind |
Bullseye flavor with openresty-valgrind |
See the Special Variants page for more details.
GitHub Container Registry (ghcr.io)
As of version 1.27.1.2-1, all images are also mirrored to the GitHub Container Registry. To pull an image from there, simply prefix the image name with ghcr.io/:
docker pull ghcr.io/openresty/openresty:bookworm