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 provider | Admin field |
|---|---|
| Bucket | Bucket name |
| Regional endpoint | S3 endpoint |
| AWS Region | Region |
| Access Key ID | Access Key ID |
| Secret Access Key | Secret Access Key |
Enable uploads and select the S3 driver. Use the bucket’s actual AWS region. Save the configuration.
Verify
- Upload a small allowed file at
/app/assets/upload. - Download it from
/app/assetsand 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.