# Installation

Imager X requires Craft 3.3 or newer.

To install Imager X, follow these steps:

  1. Install with composer via composer require spacecatninja/imager-x from your project directory.
  2. Install the plugin in the Craft Control Panel under Settings > Plugins, or from the command line via ./craft install/plugin imager-x.
  3. For Imager X to do anything, you need to configure it.


Imager X supports both GD and Imagick as image drivers, but please note that some features may not be available in all combinations of Imagick/ImageMagick. In particular, Imagick 3.4.4 compiled against ImageMagick 6.x, deprecates alot of methods, without providing alternatives. Due to how errors are handled in Imagine, this causes some issues with some of the effects.

# Upgrading from Imager 2.0

First, make sure you uninstall Imager 2.0 first, since there are conflicting dependencies.

Imager X is a drop-in replacement for Imager 2.0. All you need to do is copy over your config settings from your imager.php file to imager-x.php, and you're good to go!