# Installation
Imager X requires Craft 3.3 or newer.
To install Imager X, follow these steps:
- Install with composer via
composer require spacecatninja/imager-x
from your project directory. - Install the plugin in the Craft Control Panel under Settings > Plugins, or from the command line via
./craft install/plugin imager-x
. - For Imager X to do anything, you need to configure it.
TIP
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!