BucketMate
Providers

MinIO

Step-by-step guide to connect self-hosted MinIO or MinIO-compatible storage to BucketMate Web with access keys, a custom endpoint, and CORS settings.

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 supports HTTP and HTTPS MinIO endpoints. The BucketMate Proxy extension sends the requests, so a local endpoint works too:

http://localhost:9000

For remote servers, use HTTPS:

https://<your-minio-endpoint>

If you enter an endpoint without http:// or https://, BucketMate Web uses https://.

BucketMate Web defaults MinIO region to:

us-east-1

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

Connection steps

  1. Open BucketMate Web.
  2. Confirm the extension shows Connected in Settings > Advance.
  3. Choose Add connection.
  4. Select MinIO.
  5. Enter the MinIO endpoint.
  6. Enter the access key and secret key.
  7. Keep region as us-east-1, or enter your custom MinIO region.
  8. Add explicit bucket names if bucket listing is not allowed.
  9. Use Test Connection.
  10. Choose Save Connection.

Common issues and fixes

Extension is disconnected

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

Path-style requests

BucketMate Web always uses path-style requests, such as http://localhost:9000/<bucket>/<key>. You do not need to set MINIO_DOMAIN.

Browser trust errors

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

Endpoint does not connect

Check that the endpoint includes the correct scheme and port, such as http://localhost:9000. Without a scheme, BucketMate Web uses https://, which fails on a MinIO server without TLS.

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 MinIO servers reachable over the internet.
  • Use explicit bucket names for restricted MinIO policies.