Storage (Uploads)

Configure storage methods for uploading assets in Edesy Email including local storage and S3-compatible services.

Storage (Uploads)

There are two different supported storage methods available to handle uploading assets for templates:

  • Local
  • S3

Local

This is the default storage method and no configuration is required. It will by default serve imagery from your base URL.

S3

The S3 storage method allows for configuring any S3-compatible object storage service such as AWS S3, Digital Ocean Spaces, Minio, etc.

Under the hood it is utilizing the AWS S3 SDK so please consult whatever service you are using as to what values should be used in what places.

The URL that is generated for referencing each image can be overriden using the STORAGE_BASE_URL key.

Configuration

key type required default
STORAGE_DRIVER "s3" true
STORAGE_BASE_URL string true
STORAGE_S3_BUCKET string true
STORAGE_S3_ENDPOINT string false
STORAGE_S3_FORCE_PATH_STYLE boolean false false
AWS_REGION string false us-east-1
AWS_ACCESS_KEY_ID string true
AWS_SECRET_ACCESS_KEY string true

Use with CDN

If you are utilizing a CDN in front of your bucket, you can set the URL of the CDN to be used for all images by utilizing the STORAGE_BASE_URL parameter. Utilizing this parameter will rewrite all image URLs to use that as the base url instead of the S3 endpoint.