All Versions
111
Latest Version
Avg Release Cycle
24 days
Latest Release
9 days ago

Changelog History
Page 2

  • v4.0.1 Changes

    May 19, 2026

    🚀 This is a maintenance release with updated dependencies

  • v4.0.0 Changes

    May 13, 2026

    ➕ Added

    🔄 Changed

    • 🔨 Most of the code base is refactored to improve maintainability and extensibility.
    • 🐎 Implemented asynchronous downloading and processing of images. This improves performance when the source image is slow to download or when processing is slow.
    • Source image colorspace is now preserved when possible.
    • (pro) Improved SVG minification. It is now much faster and more efficient.
    • 📄 (pro) Improved autoquality. Implemented weighted DSSIM calculation and trained new ML models for JPEG, WebP, AVIF, and JPEG XL.
    • 👉 IMGPROXY_USE_ETAG and IMGPROXY_USE_LAST_MODIFIED are now enabled by default.
    • Etag generation is now based only on Etag received from the image source and IMGPROXY_ETAG_BUSTER config.
    • 👉 IMGPROXY_USE_GCS is not automatically set if the GCS key is present anymore. It should be set explicitly to enable loading images from Google Cloud Storage.
    • SVG rendering DPI is changed from 72 to 96 to match W3C recommendations.
    • (pro) Improved behavior of IMGPROXY_OBJECT_DETECTION_GRAVITY_MODE=one_best_centermost.
    • 📄 Custom New Relic metrics are now reported as timescales. Metric names have been changed from imgproxy.X to Custom/imgproxy/X.
    • 📚 Changed log formats. Option and argument names now match those in the documentation.
    • 🐧 (docker) imgproxy and its dependencies are now built on Ubuntu 22.04. Linux packages exported from Docker images now require a minimum libc version of 2.35.

    ✂ Removed

    • Removed deprecated IMGPROXY_CONCURRENCY config. Use IMGPROXY_WORKERS instead.
    • Removed deprecated --keypath and --saltpath CLI arguments. Use IMGPROXY_KEY and IMGPROXY_SALT environment variables instead.
    • Removed deprecated --presets CLI argument. Use IMGPROXY_PRESETS_PATH environment variable instead.
    • (pro) Removed deprecated --info-presets CLI argument. Use IMGPROXY_INFO_PRESETS_PATH environment variable instead.
    • ✂ Removed gif_options processing option, as it does nothing since v3.
    • Removed deprecated IMGPROXY_WRITE_TIMEOUT config. Use IMGPROXY_TIMEOUT instead.
    • Removed deprecated IMGPROXY_READ_TIMEOUT config. Use IMGPROXY_READ_REQUEST_TIMEOUT instead.
    • Removed obsolete IMGPROXY_MAX_SVG_CHECK_BYTES config.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_ENDPOINT config. Use OTEL_EXPORTER_OTLP_ENDPOINT instead. Unlike IMGPROXY_OPEN_TELEMETRY_ENDPOINT, OTEL_EXPORTER_OTLP_ENDPOINT should contain a URL scheme (http:// or https://).
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_PROTOCOL config. Use OTEL_EXPORTER_OTLP_PROTOCOL instead.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_GRPC_INSECURE config. Use OTEL_EXPORTER_OTLP_ENDPOINT with http:// scheme instead.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_SERVICE_NAME config. Use OTEL_SERVICE_NAME instead.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_PROPAGATORS config. Use OTEL_PROPAGATORS instead.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_CONNECTION_TIMEOUT config. Use OTEL_EXPORTER_OTLP_TIMEOUT instead.
    • Removed deprecated IMGPROXY_UNSHARPENING_MODE, IMGPROXY_UNSHARPENING_WEIGHT, IMGPROXY_UNSHARPENING_DIVIDER configs. Use IMGPROXY_UNSHARP_MASKING_MODE, IMGPROXY_UNSHARP_MASKING_WEIGHT, IMGPROXY_UNSHARP_MASKING_DIVIDER instead.
    • Removed deprecated download_duration_seconds and processing_duration_seconds histograms from Prometheus metrics. Use request_span_duration_seconds histogram with span label instead.
    • Removed obsolete IMGPROXY_DOWNLOAD_BUFFER_SIZE and IMGPROXY_BUFFER_POOL_CALIBRATION_THRESHOLD configs.

  • v4.0.0-beta.1 Changes

    April 28, 2026

    ➕ Added

    • 📄 Add preserve_hdr processing option to override the IMGPROXY_PRESERVE_HDR config on a per-request basis.
    • (pro) Add IMGPROXY_ENABLE_RAW_FORMATS config to enable support for digital camera raw formats.

    🔄 Changed

  • v4.0.0-beta.0 Changes

    April 10, 2026

    ➕ Added

    🔄 Changed

    • 🔨 Most of the code base is refactored to improve maintainability and extensibility.
    • 🐎 Implemented asynchronous downloading and processing of images. This improves performance when the source image is slow to download or when processing is slow.
    • Source image colorspace is now preserved when possible.
    • (pro) Improved SVG minification. It is now much faster and more efficient.
    • 📄 (pro) Improved autoquality. Implemented weighted DSSIM calculation and trained new ML models for JPEG, WebP, AVIF, and JPEG XL.
    • 👉 IMGPROXY_USE_ETAG and IMGPROXY_USE_LAST_MODIFIED are now enabled by default.
    • Etag generation is now based only on Etag received from the image source and IMGPROXY_ETAG_BUSTER config.
    • 👉 IMGPROXY_USE_GCS is not automatically set if the GCS key is present anymore. It should be set explicitly to enable loading images from Google Cloud Storage.
    • SVG rendering DPI is changed from 72 to 96 to match W3C recommendations.
    • (pro) Improved behavior of IMGPROXY_OBJECT_DETECTION_GRAVITY_MODE=one_best_centermost.
    • 📄 Custom New Relic metrics are now reported as timescales. Metric names have been changed from imgproxy.X to Custom/imgproxy/X.
    • 📚 Changed log formats. Option and argument names now match those in the documentation.
    • 🐧 (docker) imgproxy and its dependencies are now built on Ubuntu 22.04. Linux packages exported from Docker images now require a minimum libc version of 2.35.

    ✂ Removed

    • Removed deprecated IMGPROXY_CONCURRENCY config. Use IMGPROXY_WORKERS instead.
    • Removed deprecated --keypath and --saltpath CLI arguments. Use IMGPROXY_KEY and IMGPROXY_SALT environment variables instead.
    • Removed deprecated --presets CLI argument. Use IMGPROXY_PRESETS_PATH environment variable instead.
    • (pro) Removed deprecated --info-presets CLI argument. Use IMGPROXY_INFO_PRESETS_PATH environment variable instead.
    • ✂ Removed gif_options processing option, as it does nothing since v3.
    • Removed deprecated IMGPROXY_WRITE_TIMEOUT config. Use IMGPROXY_TIMEOUT instead.
    • Removed deprecated IMGPROXY_READ_TIMEOUT config. Use IMGPROXY_READ_REQUEST_TIMEOUT instead.
    • Removed obsolete IMGPROXY_MAX_SVG_CHECK_BYTES config.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_ENDPOINT config. Use OTEL_EXPORTER_OTLP_ENDPOINT instead. Unlike IMGPROXY_OPEN_TELEMETRY_ENDPOINT, OTEL_EXPORTER_OTLP_ENDPOINT should contain a URL scheme (http:// or https://).
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_PROTOCOL config. Use OTEL_EXPORTER_OTLP_PROTOCOL instead.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_GRPC_INSECURE config. Use OTEL_EXPORTER_OTLP_ENDPOINT with http:// scheme instead.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_SERVICE_NAME config. Use OTEL_SERVICE_NAME instead.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_PROPAGATORS config. Use OTEL_PROPAGATORS instead.
    • Removed deprecated IMGPROXY_OPEN_TELEMETRY_CONNECTION_TIMEOUT config. Use OTEL_EXPORTER_OTLP_TIMEOUT instead.
    • Removed deprecated IMGPROXY_UNSHARPENING_MODE, IMGPROXY_UNSHARPENING_WEIGHT, IMGPROXY_UNSHARPENING_DIVIDER configs. Use IMGPROXY_UNSHARP_MASKING_MODE, IMGPROXY_UNSHARP_MASKING_WEIGHT, IMGPROXY_UNSHARP_MASKING_DIVIDER instead.
    • Removed deprecated download_duration_seconds and processing_duration_seconds histograms from Prometheus metrics. Use request_span_duration_seconds histogram with span label instead.
    • Removed obsolete IMGPROXY_DOWNLOAD_BUFFER_SIZE and IMGPROXY_BUFFER_POOL_CALIBRATION_THRESHOLD configs.

  • v3.31.4 Changes

    June 09, 2026

    🛠 Fixed

    • Fix AWS credentials lifetime when IMGPROXY_S3_ASSUME_ROLE_ARN config is used.
    • (pro) Fix a rare deadlock during ML model inference.

  • v3.31.3 Changes

    April 28, 2026

    🚀 This is a maintenance release with updated dependencies

  • v3.31.2 Changes

    April 09, 2026

    🚀 This is a maintenance release with updated dependencies

  • v3.31.1 Changes

    March 17, 2026

    🛠 Fixed

    • 🛠 Fix memory leak when saving HEIC/AVIF images with alpha channel.

  • v3.31.0 Changes

    March 13, 2026

    ➕ Added

    🔄 Changed

    • 🔒 For security reasons, imgproxy now accepts only service account keys for Google Cloud Storage integration and Google Cloud Secret Manager integration.
    • When image source responds with a 4xx status code, imgproxy now responds with the same status code instead of always responding with 404 Not Found.
    • When image source responds with a 5xx status code, imgproxy now responds with 502 Bad Gateway instead of 500 Internal Server Error.
    • ✂ Remove iframe elements from SVGs during sanitization.

    🛠 Fixed

    • 🛠 Fix crop coordinates calculation when the image has an EXIF orientation different from 1 and the rotate processing option is used.
    • 🛠 Fix responding with 404 when a GCS bucket or object is missing.
    • 🛠 Fix handling : encoded as %3A in processing/info options.
    • (pro) Fix memory leak in ML features.
    • (pro) Fix generating video thumbnails when the server doesn't include the Accept-Ranges header in the response but includes the Content-Range: bytes ... header.
    • ✅ (pro) Fix watermark_size processing option behavior when one of the dimensions is zero.

    🗄 Deprecated

    • Deprecate -keypath and -saltpath CLI arguments. Use IMGPROXY_KEY and IMGPROXY_SALT environment variables instead.
    • Deprecate -presets CLI argument. Use IMGPROXY_PRESETS_PATH environment variable instead.
    • (pro) Deprecate -info-presets CLI argument. Use IMGPROXY_INFO_PRESETS_PATH environment variable instead.
    • 🗄 (pro) Deprecate support for object detection models in DarkNet format. Use ONNX format instead.

  • v3.30.1 Changes

    October 10, 2025

    🔄 Changed

    • 📇 Format New Relic and OpenTelemetry metadata values that implement the fmt.Stringer interface as strings.

    🛠 Fixed

    • (pro) Fix memory leak during video thumbnail generation.