fortrabbit/craft-object-storage

A Craft 3 plugin that integrates with fortrabbit's S3 compatible Object Storage

fortrabbit Object Storage Volume for Craft CMS

This plugin provides an Object Storage integration for Craft CMS., _(*1)

Requirements

The 4.0 release of this plugin requires Craft CMS 5 and PHP 8.0 or later., _(*2)

Installation

To install the plugin, follow these instructions., _(*3)

1. Install the plugin via composer, _(*4)

cd /path/to/project

composer require fortrabbit/craft-object-storage

2. Update your local .env file, _(*5)

Run this command in the terminal to update your .env automatically:, _(*6)

./vendor/bin/object-storage-init {your-app}

If it fails for some reason, update your .env file manually. Learn how to access credentials on fortrabbit., _(*7)

OBJECT_STORAGE_BUCKET="(YOUR_APP_NAME)"
OBJECT_STORAGE_HOST="(YOUR_APP_NAME).objects.frb.io"
OBJECT_STORAGE_KEY="(YOUR_APP_NAME)"
OBJECT_STORAGE_REGION="(us-east-1|eu-west-1)"
OBJECT_STORAGE_SECRET="(OBJECT_STORAGE_SECRET)"
OBJECT_STORAGE_SERVER="objects.(us1|eu2).frbit.com"

3. Install the plugin, _(*8)

./craft plugin/install fortrabbit-object-storage

Or browse to CP > Settings > Plugins to enable the plugin., _(*9)

4. Configure, _(*10)

Configure filesystems under: Settings > Filesystems >> [New Filesystem]., _(*11)

• Select fortrabbit Object Storage as Filesystem Type.
• For the Base URL field use $OBJECT_STORAGE_HOST ENV variable. All other fields are pre-configured with ENV vars already.
• Set a value for Expires (Cache expiration period)

Configure volumes under: Settings > Assets > [New Volume]., _(*12)

• Select the filesystem created above as the Asset Filesystem.