Search by

somehow-digital / craft-imgproxy

thasmo

imgproxy integration for Craft CMS.

Package info

github.com/somehow-digital/craft-imgproxy

Homepage

Documentation

Type:craft-plugin

pkg:composer/somehow-digital/craft-imgproxy

Statistics

Installs: 17

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 5

v1.0.4 2026-10-31 21:23 UTC

This package is auto-updated.

Last update: 2026-11-18 17:43:47 UTC


README

imgproxy logo

imgproxy for Craft CMS

Provides an imgproxy integration for Craft CMS.

Requirements

  • Craft CMS 5.8.0 or later.
  • PHP 8.2 or later.
  • imgproxy 3.0 or later.

Installation

Install this plugin from the Plugin Store or via Composer.

Plugin Store

Go to the “Plugin Store” in your project’s Control Panel, search for “imgproxy” and click on the “Install” button in its modal window.

Composer

composer require somehow-digital/craft-imgproxy
./craft plugin/install imgproxy

Configuration

  1. Go to Settings → imgproxy.
  2. Enter the Endpoint — the base URL of your imgproxy server.
  3. To enable URL signing, enter the Signature Key and Signature Salt (hex-encoded HMAC key and salt).
  4. Optionally, choose the Mode: proxy (default) points the URLs to imgproxy, store has imgproxy generate the transforms and thumbnails, which Craft stores and serves like its own.
  5. Optionally, turn off Transforms to let Craft generate the image transforms instead of imgproxy.
  6. Optionally, choose the Fallback Format (default: jpg) for sources that browsers can't display, such as HEIC and TIFF, when a transform has no format.
  7. Optionally, turn off Thumbnails to handle the thumbnails of the Control Panel like the image transforms.
  8. Optionally, choose the Thumbnail Format (default: webp) of the thumbnails imgproxy generates for the Control Panel.
  9. Click Save.

Tip: All settings support environment variables. See Environmental Configuration in the Craft CMS docs to learn more about that.

Support

somehow digital.