The Docker image for Lucee 22.214.171.124 is now available;
The Lucee Docker images are now in a new
lucee/lucee repository with a build process that generates a number of different tagged images from a matrix of the Lucee version, Tomcat Version, OpenJDK version and optional bundled NGINX and optional Alpine base image.
The same Tomcat base images are still used and the Lucee, Tomcat, and nginx configurations are all largely untouched, which means there shouldn’t be any significant issues moving from an older base image to a newer one in terms of modifications to your own
Dockerfile as all the container paths remain the same.
Updating the base image in your own projects
Dockerfile should simply involve changing the
FROM instruction, for example Lucee 5.2 + NGINX to Lucee 5.3 + NGINX;
The default application stack for Lucee 5.3 is now Java 11 (OpenJDK 11) and Tomcat 9.0, since Java 8 is EOL. Depending on your applications use of Java this might be a simple upgrade, or you might need to temporarily revert to Java 8 while any issues are resolved. We do have
jre8 tags for that
Read on below for the notes from the README about how the tags work…
Supported tags and respective Dockerfile links
Latest stable release (5.3)
Tomcat 9.0 with OpenJDK 11 (recommended)
Tomcat 9.0 with OpenJDK 8
How the tags work
The Lucee Docker image tags follow a naming convention which is used to produce “simple tags” that are updated with each release (e.g.
5.3-nginx ) as well as “full tags” which allow for very specific version targeting (e.g.
The tag naming convention is;
LUCEE_VERSIONis the Lucee Version number string. For simple tags it may optionally be in the
5.3) and for full tags it’s in the
126.96.36.199). Snapshot, RC and Beta builds always include the full version number.
RELEASE_TYPEis the type of release; omitted for Releases, otherwise
-light(optional) is a build with the Lucee “Light” JAR file, WITHOUT any extensions (users must install extensions separately, this includes database drivers, ORM, ESAPI, S3, image handling, etc)
-nginx(optional) is a build with the NGINX web server bundled and configured
-TOMCAT_VERSION-JRE_VERSIONis the Tomcat major and minor version and OpenJDK major version of the build to allow users to choose between different combinations (e.g.
tomcat9.0-jre8). This is omitted for “simple tags” where the recommended Tomcat and OpenJDK versions are used.
-alpine(optional) is a build using Alpine Linux as the base image. This results in a smaller Docker image which may be useful in some scenarios. NOTE: Alpine images currently support
jre11/ Java 11 is not available. Alpine “simple tags” such as
5.3-alpinewill be added in future builds
Legacy Lucee Docker image builds
The older Lucee Docker images will remain available in their existing Docker Hub repositories, though the build process for those images is considered “legacy” as they have been superseded by the new build matrix builds. The corresponding source is now in the
legacy branch in GitHub;
Please give the new Docker images a try and feel free to provide feedback here on the forum, or log a GitHub Issue if you have a specific problem that needs to be addressed.