> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-fr/byos/connecting-shade-to-wasabi.md).

# Connexion de Shade à Wasabi

Shade prend en charge le Bring-Your-Own-S3 (BYOS3) avec plusieurs fournisseurs tels qu’AWS, GCP, MinIO, Wasabi, Backblaze, et plus encore. Voici comment connecter Shade à votre compte Wasabi existant.

### Provisionner un nouveau bucket dans Wasabi

{% hint style="info" %}
Bien que le provisionnement d’un nouveau bucket ne soit pas strictement nécessaire, nous recommandons vivement d’en provisionner un nouveau pour Shade. Shade ne peut pas utiliser des fichiers dans des buckets existants en raison de la nature de ShadeFS. Shade créera deux nouveaux dossiers `blobs` et `chunks` dans n’importe quel bucket auquel vous le connectez.
{% endhint %}

Si vous n’avez pas encore de compte Wasabi, vous pouvez en créer un [ici](https://console.wasabisys.com). Pour créer un nouveau bucket dans Wasabi, connectez-vous à votre compte, rendez-vous dans Buckets, puis cliquez sur « Create Bucket ».

<figure><img src="https://2926217644-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&amp;token=2ea4c448-f288-44eb-a582-f929313f6cde" alt=""><figcaption></figcaption></figure>

En suivant les étapes et les invites, assurez-vous de noter votre **nom du bucket**, ainsi que votre **région du bucket** (car ils sont importants et seront utilisés à une étape ultérieure). *Dans ce cas, notre nom de bucket est « shade-bucket » et la région (non représentée) est us-east-1.*

{% hint style="info" %}
ShadeFS ne nécessite aucun autre paramètre spécifique sur le bucket. Vous pouvez choisir de répliquer les données, de journaliser ou de configurer le versioning comme vous le souhaitez pour votre entreprise.
{% endhint %}

#### Remarque spéciale concernant le CORS

Le Cross-Origin Resource Sharing est une caractéristique importante qui permet aux buckets d’être accessibles depuis d’autres origines (comme <https://app.shade.inc>). C’est essentiel pour que Shade puisse accéder et télécharger vos médias originaux depuis notre application. Par [défaut](https://docs.wasabi.com/apidocs/operations-on-buckets#bucket-crossorigin-resource-sharing-cors-support), Wasabi a correctement configuré le CORS pour autoriser toutes les origines. Cependant, si vous avez modifié ou restreint votre origine, il est nécessaire de mettre sur liste blanche `*.shade.inc` comme origine autorisée.

Vous pouvez mettre à jour la configuration dans le tableau de bord, et voici le JSON approprié :

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

### Créer des clés d’accès

Shade accède aux buckets Wasabi via le protocole S3, ce qui signifie que Shade a besoin d’un nom de bucket, d’une région de bucket, d’une clé d’accès et d’une clé secrète afin d’accéder à ce bucket.

Rendez-vous dans Access Keys > Create Access Key et provisionnez une clé Root ou Sub-User qui a accès à votre bucket nouvellement provisionné.

<figure><img src="https://2926217644-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&amp;token=2c31fa4e-f2ee-477d-b4f3-e464b33409fb" alt=""><figcaption></figcaption></figure>

Assurez-vous d’avoir téléchargé et copié les clés dans votre presse-papiers

### Créer un lecteur BYOS dans Shade

En arrivant à ce stade, vous devriez avoir acquis avec succès les éléments suivants :

1. Espace de travail Shade
2. Nom du bucket
3. Région du bucket
4. Clé d’accès
5. Clé secrète

Si vous n’avez pas encore d’espace de travail, vous pouvez en créer un [ici](https://app.shade.inc).

Dans votre espace de travail Shade, vous pouvez maintenant créer un lecteur. Sélectionnez le bouton plus à côté de « My drives » > lecteur BYOS.

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FjqzLgveMAH1u4Jue0PBb%2FScreenshot%202025-07-21%20at%209.43.17%E2%80%AFPM.png?alt=media&amp;token=f29ba862-4ea3-454a-9b60-6a14622fa1e5" alt=""><figcaption></figcaption></figure>

#### Sélectionnez un modèle

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FPE80uq4lWAvyvhx7ZpEn%2FScreenshot%202025-07-21%20at%209.43.25%E2%80%AFPM.png?alt=media&amp;token=72b36257-7e12-4c7e-95b5-7d8e29632adc" alt=""><figcaption></figcaption></figure>

Nos modèles vous aident à configurer rapidement Shade avec des métadonnées et des vues supplémentaires qui vous aident à organiser vos fichiers et vos ressources. Pour plus d’informations sur notre IA, vous pouvez consulter notre [academy](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). Dans ce cas, nous avons चयनné Production vidéo.

#### Création de notre lecteur Wasabi

Ensuite, nous définissons le nom de notre lecteur et sélectionnons notre fournisseur Wasabi.

<figure><img src="https://2926217644-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&amp;token=6bdbe5bc-af88-4bd2-81c1-9b3ad362415a" alt=""><figcaption></figcaption></figure>

#### Ajout de nos identifiants Wasabi

À partir des étapes précédentes, nous ajoutons nos identifiants Wasabi, notamment le nom de notre bucket, la région, la clé d’accès et la clé secrète.

{% hint style="info" %}
Cela doit être le nom du bucket que vous avez créé dans Wasabi. Ce n’est pas le même que le nom du lecteur que vous avez créé sur l’écran précédent.
{% endhint %}

<figure><img src="https://2926217644-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&amp;token=33a14d3c-569a-4ab8-994c-a10a847c9bd8" alt=""><figcaption></figcaption></figure>

### Téléchargement de votre premier fichier

Une fois que vous avez suivi les étapes précédentes, vous êtes maintenant en mesure de téléverser votre premier fichier vers votre lecteur Shade. Si la configuration a réussi, vous devriez pouvoir téléverser votre fichier et monter le lecteur Shade sur votre ordinateur depuis l’ [application de bureau Shade](https://shade.inc/download)

<figure><img src="https://2926217644-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&amp;token=32cda603-88ed-4cb6-a0e9-4124c8734011" alt=""><figcaption></figcaption></figure>

### Conseils de dépannage

Si vous avez d’autres questions, n’hésitez pas à nous contacter à <support@shade.inc> ou rejoignez notre [Discord](https://discord.gg/h8wqFMJ4vK).

#### Je n’arrive pas à téléverser, que se passe-t-il ?

Si vous n’arrivez pas à téléverser, veuillez vérifier les paramètres CORS de votre bucket ou vos clés secrètes / d’accès ainsi que les autorisations associées.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.