Image Metadata Labels

The docker-openresty images are built with a rich set of Docker labels that provide metadata about the build process and the versions of included components. This is invaluable for introspection and debugging.

Inspecting Labels

You can inspect the labels of any image using the docker inspect command. Using a tool like jq can format the output nicely.

docker pull openresty/openresty:jammy
docker inspect openresty/openresty:jammy | jq '.[].Config.Labels'

Example Output:

{
  "maintainer": "Evan Wies <evan@neomantra.net>",
  "resty_add_package_builddeps": "",
  "resty_add_package_rundeps": "",
  "resty_config_deps": "--with-pcre ...",
  "resty_config_options": "--with-compat --with-file-aio ...",
  "resty_config_options_more": "",
  "resty_eval_post_download_pre_configure": "",
  "resty_eval_post_make": "",
  "resty_eval_pre_configure": "",
  "resty_image_base": "ubuntu",
  "resty_image_tag": "jammy",
  "resty_luajit_options": "--with-luajit-xcflags='-DLUAJIT_NUMMODE=2 -DLUAJIT_ENABLE_LUA52COMPAT'",
  "resty_luarocks_version": "3.12.2",
  "resty_openssl_build_options": "enable-camellia enable-seed ...",
  "resty_openssl_patch_version": "3.4.1",
  "resty_openssl_url_base": "https://github.com/openssl/openssl/releases/download/openssl-3.4.1",
  "resty_openssl_version": "3.4.1",
  "resty_pcre_build_options": "--enable-jit --enable-pcre2grep-jit ...",
  "resty_pcre_sha256": "86b9cb0aa3bcb7994faa88018292bc704cdbb708e785f7c74352ff6ea7d3175b",
  "resty_pcre_version": "10.44",
  "resty_version": "1.27.1.2"
}

Key Labels

This table describes some of the most important labels. Most labels correspond directly to a build argument used during the image creation.

Label Name	Description
resty_version	The version of OpenResty.
resty_openssl_version	The version of OpenSSL used in the build.
resty_pcre_version	The version of PCRE2 used in the build.
resty_luarocks_version	The version of LuaRocks installed.
resty_image_base	The base image name (e.g., ubuntu, alpine).
resty_image_tag	The tag of the base image (e.g., jammy, 3.22.1).
resty_config_options	The primary ./configure options passed to OpenResty.
resty_config_options_more	Additional ./configure options.
resty_deb_version	For DEB-based images, the specific package version installed.
resty_rpm_version	For RPM-based images, the specific package version installed.
resty_apk_version	For APK-based images, the specific package version installed.