# Installation

Imager X 5.0 requires Craft 5.0 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. 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.