# MinIO

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

Canonical: https://docs.bucketmate.app/web/providers/connect-minio

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:

```text
https://<your-minio-endpoint>
```

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

```text
https://localhost:9000
```

BucketMate Web defaults MinIO region to:

```text
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 bridge is connected.
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. 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.