Overview

Imgproxy is a performant 1-container server for resizing, converting, cropping, and manipulating images on-the-fly. The guiding principles behind imgproxy are security, speed, and simplicity.

Imgproxy was built with security in mind. This template will automatically set the imgproxy key and salt. Make sure your application use these key or else imgproxy will refuse to serve the request.

Highlights

• Fast and performant: Imgproxy was built using libvips, the most efficient image processing library available.
• Feature rich: You can crop, resize, zoom, enlarge, rotate, add backgrounds, and add watermarks all for free. Pro version comes with even more features for advanced users.
• Stability: This template is automatically configured with a health check to make sure your imgproxy instance is always up and running.

Configuration

By default, this template will generate the IMGPROXY_KEY, IMGPROXY_SALT, IMGPROXY_USE_ETAG, and IMGPROXY_TTL to a sensible default value. For further customization, please take a look at the documentation

Generating key and salt

imgproxy expects the IMGPROXY_KEY and IMGPROXY_SALT to be hex-encoded. The template will automatically configure this for you.

If you want to generate your own, run the following on a linux machine:

echo $(xxd -g 2 -l 64 -p /dev/random | tr -d '\n')

See this page for more info.

Updating

This template currently deploys imgproxy version 3.18.2 which is the latest version as of August 4th, 2023. You can edit the docker image version manually if a newer version is available.

License and Links

imgproxy is distributed with the MIT License. A "pro" version of imgproxy is available and may be licensed under a different license.