# Browser extension

> Install the BucketMate Proxy extension, check its status, and fix extension errors in BucketMate Web

Canonical: https://docs.bucketmate.app/web/features/browser-extension

BucketMate Web needs the companion extension **BucketMate Proxy** to reach your storage provider. BucketMate Web signs each S3 request in the page, then the extension sends it to the provider endpoint. Because the request does not come from the web page, you do not need to add CORS rules to your buckets.

## Install the extension

1. Open the [browser extension guide](https://bucketmate.app/browser-extensions).
2. Install **BucketMate Proxy** for your browser. Store builds exist for Chrome, Microsoft Edge, and Firefox.
3. Open or refresh [BucketMate Web](https://web.bucketmate.app).
4. Check that the extension status shows **Connected**.

BucketMate Web checks for the extension when the page loads. If you install the extension while BucketMate Web is open, refresh the page.

## Check the extension status

You can check the status in two places:

- The **Browser extension** section of the welcome guide. Open it again from **Settings > General > Onboarding guide > Open Guide**.
- **Settings > Advance > Extension bridge**, which shows **Connected** or **Disconnected** and the last error.

When the extension is not detected, BucketMate Web shows a banner: "Companion browser extension is not connected." Choose **Configure** to open **Settings > Advance**. Use **Open Guideline** there to open the install guide.

## Review proxied requests

Click the BucketMate Proxy icon in the browser toolbar to open its request log.

- **Total**, **Success**, and **Errors** count recent requests.
- Each entry shows the HTTP method, status code, host, path, time, and duration.
- **Refresh** reloads the list.
- **Clear** removes the log.

The extension keeps the last 80 requests in extension storage. It does not store request headers, credentials, or file contents.

## Where the extension works

The extension only connects to BucketMate Web at `https://web.bucketmate.app`. It can forward requests to any `http://` or `https://` storage endpoint.

## Troubleshooting

### Extension is disconnected

1. Confirm BucketMate Proxy is installed and enabled in your browser's extension settings.
2. Refresh BucketMate Web.
3. Check **Settings > Advance > Extension bridge**.

### "Proxy extension not detected"

BucketMate Web could not reach the extension before sending a request. Enable the extension, then refresh the page.

### "Proxy extension did not respond"

A request took longer than 2 minutes. Check your network connection and the provider endpoint, then try again. Very large uploads can also take this long.

### "BucketMate Proxy only supports HTTP and HTTPS storage endpoints"

The endpoint URL uses an unsupported scheme. Edit the connection and use an endpoint that starts with `https://` or `http://`.

### Requests fail with provider errors

Open the extension request log and check the status code for the failed request. A `403` usually means the access key lacks permission. A `301` usually means the region or endpoint does not match the bucket.