MinIO

Connect self-hosted MinIO or MinIO-compatible storage to BucketMate Web

BucketMate Web connects to MinIO through its S3-compatible endpoint. Make sure the companion browser extension is connected before testing the connection.

Prerequisites

MinIO endpoint URL
Access key
Secret key
Bucket name, or permission to list buckets
BucketMate browser extension

Endpoint and region

BucketMate Web requires HTTPS for MinIO endpoints. HTTP endpoints, including localhost endpoints like http://localhost:9000, are not supported.

Use your HTTPS MinIO endpoint:

https://<your-minio-endpoint>

For local MinIO development, configure TLS and connect through an HTTPS endpoint:

https://localhost:9000

BucketMate Web defaults MinIO region to:

us-east-1

If your MinIO deployment uses another region, choose Custom and enter it.

Connection steps

Open BucketMate Web.
Confirm the extension bridge is connected.
Choose Add Connection.
Select MinIO.
Enter the MinIO endpoint.
Enter the access key and secret key.
Keep region as us-east-1, or enter your custom MinIO region.
Add explicit bucket names if bucket listing is not allowed.
Use Test Connection.
Save the connection.

Common issues and fixes

Extension is disconnected

Install or reconnect the companion browser extension, then test again.

Path-style vs virtual-hosted style

MinIO defaults to path-style requests. Fix by using path-style URLs, or configure MINIO_DOMAIN to enable virtual-hosted-style access.

Bucket subdomain conflicts

When MINIO_DOMAIN is enabled, subdomains are treated as bucket names. Fix by ensuring DNS records and bucket names do not conflict with other subdomains.

Browser trust errors

If MinIO uses a self-signed certificate, make sure your browser trusts the certificate before connecting from BucketMate Web.

HTTP endpoint does not connect

BucketMate Web supports HTTPS MinIO endpoints only. Configure TLS for MinIO and use an endpoint that starts with https://.

Bucket list permission is restricted

If your MinIO policy allows object access but not bucket listing, add bucket names in Explicit Buckets.

BucketMate Web tips

Use HTTPS for all MinIO endpoints, including localhost.
Use explicit bucket names for restricted MinIO policies.