Upcoming Breaking Changes for Nginx

On May 3 2023 the Chainguard nginx image will be rebuilt with several improvements, including breaking changes. You may need to take action to update your application to prevent disruption.

Specifically, the config file is being changed to bring the default configuration closer to that of official nginx image. If you override the config with a custom configuration, you should not be affected.

The changes include:

• Moving the default port from 80 to 8080. This is required to run on Kubernetes as a non-privileged user.

• Setting nginx to automatically determine the number of worker processes

• Moving the HTML directory to /usr/share/nginx/html

You can test the new image out now by pulling the cgr.dev/chainguard/nginx:next image. This is a temporary tag that will be removed shortly after May 3, 2023, when the changes will merged into the latest image.