Setup

To create a new asset volume for your Amazon S3 bucket, go to Settings → Assets, create a new volume, and set the Volume Type setting to “Linode S3”.

Environment Variables

To allow you to setup different Buckets for different environments, you can set these handy environment variables in your .env and .env.example (so you don't forget them after pushing to source control):

# The Linode Object Storage Access Key with read/write access to Buckets
LINODE_S3_ACCESS_KEY=

# The Linode Object Storage Access Secret
LINODE_S3_SECRET=

# THE URL endpoint for your Buckets
LINODE_S3_ENDPOINT=

# The region your Object Storage bucket is in
LINODE_S3_REGION=

# The name of your bucket
LINODE_S3_BUCKET=

# The URL of the bucket
LINODE_S3_BUCKET_URL=

You can also overwrite the settings of a volume using a config/volumes.php file. That would look something like this:

<?php

return [
    'linodeOSVolumeHandle' => [
        'hasUrls' => true,
        'url' => getenv('LINODE_S3_BUCKET_URL'),
        'keyId' => getenv('LINODE_S3_ACCESS_KEY'),
        'secret' => getenv('LINODE_S3_SECRET'),
        'endpoint' => getenv('LINODE_S3_ENDPOINT'),
        'region' => getenv('LINODE_S3_REGION'),
        'bucket' => getenv('LINODE_S3_BUCKET'),
    ],
];