Storage

S3 Storage

The S3 storage uploads transformations to a S3 bucket, or any other provider implementing the S3 interface (for example Digital Ocean Spaces).

Digital Ocean can be used by adding an endpoint.

Example

config.yml

storage:
  s3:
    access_key_id: 'xxxx'
    secret_access_key: 'yyyy'
    region: 'nyc3'
    bucket_name: 'zzz'
    path: '/:preset/:image'

Options

Name
access_key_id	Access key id from S3 Type: string Required
secret_access_key	Secret access key from S3 Type: string Required
region	Region of S3 bucket Type: string Required
bucket_name	Name of bucket Type: string Required
path	Path of the original image in the bucket. Type: string with parameters Required
endpoint	Which endpoint to use, useful if using Digital Ocean Spaces. Type: string Default: derived from bucket_name and region, as per AWS standard.
ACL	What ACL should be set on the uploaded object. See available values here: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html. Type: string Default: 'private'

Hash header

SpaceChop makes use of a metadata header x-amz-meta-hash on storages in order to keep transformations up to date as preset configuration changes.