fortrabbit/craft-object-storage

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

Installs: 15 959

Dependents: 2

Suggesters: 0

Security: 0

Stars: 3

Watchers: 4

Forks: 8

Open Issues: 1

Type:craft-plugin

4.0.0 2024-04-22 11:56 UTC

README

This plugin provides an Object Storage integration for Craft CMS.

Requirements

The 4.0 release of this plugin requires Craft CMS 5 and PHP 8.0 or later.

Installation

To install the plugin, follow these instructions.

1. Install the plugin via composer

cd /path/to/project

composer require fortrabbit/craft-object-storage

2. Update your local .env file

Run this command in the terminal to update your .env automatically:

./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.

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

./craft plugin/install fortrabbit-object-storage

Or browse to CP > Settings > Plugins to enable the plugin.

4. Configure

Configure filesystems under: Settings > Filesystems >> [New Filesystem].

  • 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].

  • Select the filesystem created above as the Asset Filesystem.