README

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 Fallback Format (default: jpg) for sources that browsers can't display, such as HEIC and TIFF, when a transform has no format.
5. Optionally, turn off Thumbnails to let Craft generate the thumbnails of the Control Panel instead of imgproxy.
6. Optionally, choose the Thumbnail Format (default: webp) of the thumbnails imgproxy generates for the Control Panel.
7. Click Save.

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

somehow digital.