Kernlift

MinIO

Store uploaded files with MinIO.

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 MinIO

Create the bucket

Open MinIO. Open your MinIO Console and create a bucket.

Create application keys

Issue application credentials under Access Keys with object access to that bucket.

Record the S3 endpoint

Record the S3 API endpoint reachable from Kernlift and the signing region.

Provider documentation · MinIO identity management

Configure the application

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

Value from providerAdmin field
BucketBucket name
API addressS3 endpoint
Signing regionRegion
Access KeyAccess Key ID
Secret KeySecret Access Key

Enable uploads and select the S3 driver. Use the S3 API address accessible to the server. Save the configuration.

Kernlift settings for MinIO

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