Kernlift

Amazon S3

Store uploaded files with Amazon S3.

Before you begin

An account with access to the provider and permission to edit the settings below in Kernlift.

Expected result — an uploaded file you can download again.

Set up Amazon S3

Create a private bucket

Open Amazon S3. Create a private bucket in the target region.

Grant object permissions

Grant an application identity GetObject, PutObject and DeleteObject on its objects.

Issue the access key

Create an access key and save its secret.

Provider documentation · creating an S3 bucket · IAM access keys

Configure the application

Open /admin/config/storage in the Kernlift admin console.

Value from providerAdmin field
BucketBucket name
Regional endpointS3 endpoint
AWS RegionRegion
Access Key IDAccess Key ID
Secret Access KeySecret Access Key

Enable uploads and select the S3 driver. Use the bucket’s actual AWS region. Save the configuration.

Kernlift settings for Amazon S3

Verify

  1. Upload a small allowed file at /app/assets/upload.
  2. Download it from /app/assets and check the content.

Troubleshooting

S3 upload fails with "Storage upload failed (403)"

The error shows the provider's own code and message. Check the access key, secret and bucket name, and that Region matches what the endpoint expects for signing.

Next steps

Set up file storage and uploads