Skip to content
KAZCODE Universal Storage KAZCODE Universal Storage

MinIO

MinIO is what this plugin’s own integration tests run against, so it’s the most thoroughly exercised non-AWS provider.

Before you begin

A running MinIO server (self-hosted or via Docker) and its access key/secret.

Steps

  1. In Universal Storage → Settings, choose provider preset MinIO.
  2. Set Endpoint to your MinIO server’s API URL (for example https://minio.example.com, or http://localhost:9000 for local development).
  3. Enable Force Path Style — MinIO typically requires path-style requests, and this isn’t turned on automatically by picking the preset.
  4. Enter your MinIO access key and secret, then Test connection.

Verify it worked

Test connection passes all steps. Uploading a test image (see Your first upload) shows the file in your MinIO bucket.

Troubleshooting

Connection fails over plain HTTP in local development — this is expected for self-signed/no-TLS local MinIO instances; confirm the endpoint’s scheme (http:// vs https://) and port match your actual MinIO configuration.

Connection fails with a path-style error — confirm Force Path Style is enabled; turning it off is rarely correct for MinIO.