# Installation
Imager X 5.0 requires Craft 5.0 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
. - Configure it, and you're off to space!
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 X 4.0 to 5.0
There should be no breaking changes going from 4.0 to 5.0.
# Upgrading from Imager X 3.0 to 5.0
There should be no breaking changes going from 3.0 to 5.0. A couple of things that was marked as deprecated in 3.0 was removed in 4.0, so make sure you solve any deprecation errors in Craft 3.0 before upgrading.