PHPackages                             spacecatninja/imager-x-do-spaces-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-do-spaces-driver

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

spacecatninja/imager-x-do-spaces-driver
=======================================

External storage driver for Imager X that integrates with DigitalOcean Spaces

4.0.0(2y ago)29.6k↓15.4%1[2 issues](https://github.com/spacecatninja/craft-imager-x-do-spaces-driver/issues)MITPHPPHP ^8.0

Since Feb 14Pushed 2y ago1 watchersCompare

[ Source](https://github.com/spacecatninja/craft-imager-x-do-spaces-driver)[ Packagist](https://packagist.org/packages/spacecatninja/imager-x-do-spaces-driver)[ RSS](/packages/spacecatninja-imager-x-do-spaces-driver/feed)WikiDiscussions master Synced 1mo ago

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

Imager X Storage Driver for DigitalOcean Spaces
===============================================

[](#imager-x-storage-driver-for-digitalocean-spaces)

This is an external storage driver for Imager X that uploads your Imager transforms to DigitalOcean's Spaces object storage. Spaces is an AWS S3 compatible object storage, so the plugin utilizes the same S3 client as Imager's AWS storage does.

This plugin also serves as a good reference point if you want to create your own external storage driver for Imager to integrate with an unsupported third-party object storage. It's really simple, and you can do it either from a Craft 3 plugin, if you want to share it with the rest of the community (please do!), or a module, if you're using something proprietary/custom.

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

[](#requirements)

This plugin requires Craft CMS 5.0.0-beta.1 or later, and Imager X 5.0.0-beta.1 or later. External storages are only available in the Pro edition of Imager.

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

[](#installation)

To install the plugin, follow these instructions:

1. Install with composer via `composer require spacecatninja/imager-x-do-spaces-driver` 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-do-spaces-driver`.

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

[](#configuration)

Configure the storage driver by adding new key named `dospaces` to the `storagesConfig` config setting in your **imager-x.php config file**, with the following configuration:

```
'storageConfig' => [
    'dospaces' => [
        'endpoint' => '',
        'accessKey' => '',
        'secretAccessKey' => '',
        'region' => '',
        'bucket' => '',
        'folder' => '',
        'requestHeaders' => array(),
    ]
],

```

Enable the storage driver by adding the key `dospaces` to Imager's `storages` config setting:

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

```

Here's an example config, note that the endpoint has to be a complete URL with scheme, and as always you need to make sure that `imagerUrl` is pointed to the right location:

```
'imagerUrl' => 'https://imager-test-bucket.ams3.digitaloceanspaces.com/transforms/',
'storages' => ['dospaces'],
'storageConfig' => [
    'dospaces'  => [
        'endpoint' => 'https://ams3.digitaloceanspaces.com',
        'accessKey' => 'MYACCESSKEY',
        'secretAccessKey' => 'MYSECRETKEY',
        'region' => 'ams3',
        'bucket' => 'imager-test-bucket',
        'folder' => 'transforms',
        'requestHeaders' => array(),
    ]
],

```

Also remember to always empty your Imager transforms cache when adding or removing external storages, as the transforms won't be uploaded if the transform already exists in the cache.

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

29

—

LowBetter than 59% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity66

Established project with proven stability

 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

Every ~291 days

Recently: every ~364 days

Total

6

Last Release

828d ago

Major Versions

v2.x-dev → 3.0.0-beta2022-04-18

v3.x-dev → 4.0.02024-02-10

### 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 (5 commits)")

---

Tags

cmsCraftcraftcmscraft-pluginspacesdigitaloceanimager-x

### Embed Badge

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

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

###  Alternatives

[vaersaagod/dospaces

DigitalOcean Spaces integration for Craft CMS

36100.3k1](/packages/vaersaagod-dospaces)[servd/craft-remote-assets

Move CP assets to an external filesystem such as S3

1215.8k](/packages/servd-craft-remote-assets)[weareferal/remote-backup

Backup your database and assets to a remote location

115.5k](/packages/weareferal-remote-backup)[venveo/craft-compress

Create smart zip files from Craft assets on the fly

124.6k](/packages/venveo-craft-compress)[markdrzy/importable

Add CSV data import functionality to the native Table fieldtype.

114.6k2](/packages/markdrzy-importable)

PHPackages © 2026

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