PHPackages                             spacecatninja/imager-x-aws-storage-driver - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. spacecatninja/imager-x-aws-storage-driver

ActiveCraft-plugin[File & Storage](/categories/file-storage)

spacecatninja/imager-x-aws-storage-driver
=========================================

External storage driver for Imager X that integrates with AWS (S3)

1.0.0(1mo ago)00MITPHPPHP ^8.0

Since Mar 6Pushed 1mo agoCompare

[ Source](https://github.com/spacecatninja/craft-imager-x-aws-storage-driver)[ Packagist](https://packagist.org/packages/spacecatninja/imager-x-aws-storage-driver)[ RSS](/packages/spacecatninja-imager-x-aws-storage-driver/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (3)Versions (2)Used By (0)

Imager X Storage Driver for AWS (S3)
====================================

[](#imager-x-storage-driver-for-aws-s3)

External storage driver for [Imager X](https://plugins.craftcms.com/imager-x) that uploads transformed images to Amazon S3. Supports CloudFront cache invalidation and credential-less authentication for ECS/EC2 environments.

Requirements
------------

[](#requirements)

- Craft CMS 5.0.0 or later
- Imager X 6.0.0 or later (Pro edition)

Installation
------------

[](#installation)

```
composer require spacecatninja/imager-x-aws-storage-driver
php craft plugin/install imager-x-aws-storage-driver
```

Configuration
-------------

[](#configuration)

Add an `aws` key to `storageConfig` in your `config/imager-x.php`:

```
'storages' => ['aws'],

'storageConfig' => [
    'aws' => [
        'accessKey' => '',
        'secretAccessKey' => '',
        'region' => 'eu-west-1',
        'bucket' => 'my-bucket',
        'folder' => 'transforms',
        'storageType' => 'standard',
        'requestHeaders' => [],
        'disableACL' => false,
        'public' => true,
        'cloudfrontInvalidateEnabled' => false,
        'cloudfrontDistributionId' => '',
    ],
],
```

Point `imagerUrl` at your bucket (or CloudFront distribution):

```
'imagerUrl' => 'https://my-bucket.s3.eu-west-1.amazonaws.com/transforms/',
```

Always flush your Imager transforms cache when adding or removing external storages, as existing cached transforms will not be re-uploaded.

Configuration options
---------------------

[](#configuration-options)

OptionDefaultDescription`accessKey``''`AWS access key ID. Supports environment variables (e.g. `$AWS_ACCESS_KEY`).`secretAccessKey``''`AWS secret access key. Supports environment variables.`region``''`AWS region (e.g. `eu-west-1`).`bucket``''`S3 bucket name. Supports environment variables.`folder``''`Folder prefix within the bucket.`storageType``'standard'`S3 storage class. Accepts `standard`, `rrs` (Reduced Redundancy), or `glacier`.`requestHeaders``[]`Additional headers merged into the S3 `putObject` request (e.g. `Content-Encoding`).`disableACL``false`Set to `true` to skip setting an ACL on upload (required for buckets with ACLs disabled).`public``true`When ACL is enabled, sets objects to `public-read`. Set to `false` for `private`.`cloudfrontInvalidateEnabled``false`Send a CloudFront invalidation request after each upload.`cloudfrontDistributionId``''`CloudFront distribution ID to invalidate.`useCredentialLessAuth``false`Skip access key credentials and rely on IAM roles instead (web identity, ECS, or EC2 instance profile).Credential-less authentication
------------------------------

[](#credential-less-authentication)

When running on AWS infrastructure (ECS, EC2, or with web identity federation), you can omit `accessKey` and `secretAccessKey` and let the SDK resolve credentials from the environment automatically:

```
'aws' => [
    'useCredentialLessAuth' => true,
    'region' => 'eu-west-1',
    'bucket' => 'my-bucket',
    'folder' => 'transforms',
],
```

The driver checks for `AWS_WEB_IDENTITY_TOKEN_FILE`/`AWS_ROLE_ARN` (web identity), `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI` (ECS), and falls back to the EC2 instance metadata service.

Price, license and support
--------------------------

[](#price-license-and-support)

The plugin is released under the MIT license. It requires Imager X Pro, which is a commercial plugin [available in the Craft plugin store](https://plugins.craftcms.com/imager-x).

###  Health Score

36

—

LowBetter than 81% of packages

Maintenance94

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

32d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/806fbb515be53ddbca1d658f1abe7f8ddd41d77b72eec8aa85800db3a03e7e35?d=identicon)[spacecatninja](/maintainers/spacecatninja)

---

Top Contributors

[![aelvan](https://avatars.githubusercontent.com/u/2675644?v=4)](https://github.com/aelvan "aelvan (2 commits)")

---

Tags

s3awscmsCraftcraftcmscraft-pluginimager-x

### Embed Badge

![Health badge](/badges/spacecatninja-imager-x-aws-storage-driver/health.svg)

```
[![Health](https://phpackages.com/badges/spacecatninja-imager-x-aws-storage-driver/health.svg)](https://phpackages.com/packages/spacecatninja-imager-x-aws-storage-driver)
```

###  Alternatives

[craftcms/aws-s3

Amazon S3 integration for Craft CMS

631.5M26](/packages/craftcms-aws-s3)[servd/craft-remote-assets

Move CP assets to an external filesystem such as S3

1215.8k](/packages/servd-craft-remote-assets)[venveo/craft-compress

Create smart zip files from Craft assets on the fly

124.6k](/packages/venveo-craft-compress)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)