# Connecting Shade to Wasabi

Shade supports Bring-Your-Own-S3 (BYOS3) with multiple providers such as AWS, GCP, MinIO, Wasabi, Backblaze, and more. Here’s how to connect Shade with your existing Wasabi account.

### Provisioning a New Bucket in Wasabi

{% hint style="info" %}
Although provisioning a new bucket is not strictly necessary, we highly recommend provisioning a new bucket for Shade. Shade is unable to use files in existing buckets due to the nature of ShadeFS. Shade will create two new folders `blobs` and `chunks` to any bucket that you connect to it.
{% endhint %}

If you do not have a Wasabi account already, you can create an account [here](https://console.wasabisys.com). To create a new bucket in Wasabi, sign in to your account, head to Buckets, and “Create Bucket”.

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FGby1mYxLsZf9KGOzceCb%2FScreenshot%202025-07-21%20at%209.42.04%E2%80%AFPM.png?alt=media&#x26;token=2ea4c448-f288-44eb-a582-f929313f6cde" alt=""><figcaption></figcaption></figure>

Following the steps and prompts, ensure that you keep track of your **bucket name**, and your **bucket region** (as these are important and will be used in a later step). *In this case, our bucket name is “shade-bucket” and the region (not depicted) is us-east-1.*

{% hint style="info" %}
ShadeFS does not require any other specific properties to be set on the bucket. You may opt to replicate data, log, or set up versioning as you prefer for your business.
{% endhint %}

#### Special note about CORS

Cross-Origin Resource Sharing is an important characteristic that allows buckets to be accessible from other origins (such as <https://app.shade.inc>). This is critical for Shade to access and download original media for you from our app. By [default](https://docs.wasabi.com/apidocs/operations-on-buckets#bucket-crossorigin-resource-sharing-cors-support), Wasabi has properly set up CORS to allow all origins. However, if you have changed or restricted your origin, it is required to whitelist `*.shade.inc` as an allowed-origin.

You can update the configuration in the dashboard and here is the proper JSON:&#x20;

```
[
  {
    "AllowedHeaders": [
      "*"
    ],
    "AllowedMethods": [
      "GET",
      "PUT",
      "POST",
      "DELETE",
      "HEAD"
    ],
    "AllowedOrigins": [
      "*"
    ],
    "MaxAgeSeconds": 3000
  }
]
```

### Creating Access Keys

Shade accesses Wasabi buckets via the S3 protocol, this means that Shade requires a bucket name, a bucket region, access key, and secret key in order to access this bucket.

Head to Access Keys > Create Access Key and provision a Root or Sub-User key that has access to your newly provisioned bucket.

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F7iyAtxn3btAvZdeL4akq%2FScreenshot%202025-07-21%20at%209.42.54%E2%80%AFPM.png?alt=media&#x26;token=2c31fa4e-f2ee-477d-b4f3-e464b33409fb" alt=""><figcaption></figcaption></figure>

Ensure you have downloaded and copied the keys to your clipboard

### Creating a BYOS Drive in Shade

Reaching this point, you should have successfully acquired the following items:

1. Shade Workspace
2. Bucket Name
3. Bucket Region
4. Access Key
5. Secret Key

If you do not have a workspace already, you can create one [here](https://app.shade.inc).

Within your Shade workspace, you can now create a drive. Selecting the plus button next to “My drives” > BYOS drive.

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F5GrmVTIvNOwwlLXFE5B0%2FScreenshot%202025-07-21%20at%209.43.17%E2%80%AFPM%20(1).png?alt=media&#x26;token=47145a06-8184-476d-85df-d032b2a06084" alt=""><figcaption></figcaption></figure>

#### Select a Template

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FUS2JrtZacwGYeBTn7nCN%2FScreenshot%202025-07-21%20at%209.43.25%E2%80%AFPM%20(1).png?alt=media&#x26;token=b94e13c1-33cd-4e62-ac1b-ae7a47c9daf7" alt=""><figcaption></figcaption></figure>

Our templates help you get set up quickly with Shade with additional metadata and views that help you organize your files and assets. For more information about our AI you can check out our [academy](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). In this case, we have selected Video Production.

#### Creating our Wasabi Drive

Next, we decide on our drive name and select our provider Wasabi.

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FG4IELRlQGdywO97eQ7SS%2FScreenshot%202025-07-21%20at%209.43.34%E2%80%AFPM.png?alt=media&#x26;token=6bdbe5bc-af88-4bd2-81c1-9b3ad362415a" alt=""><figcaption></figcaption></figure>

#### Adding Our Wasabi Credentials

From the previous steps, we add our Wasabi credentials including our bucket name, region, access key and secret key.

{% hint style="info" %}
This has to be the bucket name that you created in Wasabi. This is not the same as the drive name that you created on the previous screen.
{% endhint %}

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FaYZgOmWk6xhdFkGjAk4z%2FScreenshot%202025-07-21%20at%209.44.02%E2%80%AFPM.png?alt=media&#x26;token=33a14d3c-569a-4ab8-994c-a10a847c9bd8" alt=""><figcaption></figcaption></figure>

### Uploading your first file

Once you have followed the previous steps, you are now able to upload your first file to your Shade drive. If configured successfully, you should be able to upload your file and mount the Shade drive to your computer from the [Shade Desktop App](https://shade.inc/download)

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F64bJhaCemet6iLpQFXWz%2FScreenshot%202025-07-21%20at%209.45.00%E2%80%AFPM.png?alt=media&#x26;token=32cda603-88ed-4cb6-a0e9-4124c8734011" alt=""><figcaption></figcaption></figure>

### Troubleshooting Tips

If you have more questions - feel free to contact us at <support@shade.inc> or join our [discord](https://discord.gg/h8wqFMJ4vK).

#### I can’t upload, what’s going on?

If you are unable to upload, please check your CORS settings on your bucket or your secret / access keys and its associated permissions.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.shade.inc/byos/connecting-shade-to-wasabi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.