> 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-es/byos/connecting-shade-to-wasabi.md).

# Conectar Shade a Wasabi

Shade admite Bring-Your-Own-S3 (BYOS3) con múltiples proveedores como AWS, GCP, MinIO, Wasabi, Backblaze y más. Aquí te explicamos cómo conectar Shade con tu cuenta de Wasabi existente.

### Aprovisionamiento de un nuevo bucket en Wasabi

{% hint style="info" %}
Aunque aprovisionar un nuevo bucket no es estrictamente necesario, recomendamos encarecidamente aprovisionar un nuevo bucket para Shade. Shade no puede usar archivos en buckets existentes debido a la naturaleza de ShadeFS. Shade creará dos nuevas carpetas `blobs` y `chunks` en cualquier bucket que conectes a él.
{% endhint %}

Si aún no tienes una cuenta de Wasabi, puedes crear una cuenta [aquí](https://console.wasabisys.com). Para crear un nuevo bucket en Wasabi, inicia sesión en tu cuenta, ve a Buckets y selecciona “Create Bucket”.

<figure><img src="https://440362858-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>

Siguiendo los pasos e indicaciones, asegúrate de llevar un registro de tu **nombre del bucket**, y de tu **región del bucket** (ya que estos son importantes y se usarán en un paso posterior). *En este caso, nuestro nombre de bucket es “shade-bucket” y la región (no mostrada) es us-east-1.*

{% hint style="info" %}
ShadeFS no requiere que se configure ninguna otra propiedad específica en el bucket. Puedes optar por replicar datos, registrar eventos o configurar el versionado como prefieras para tu negocio.
{% endhint %}

#### Nota especial sobre CORS

Cross-Origin Resource Sharing es una característica importante que permite que los buckets sean accesibles desde otros orígenes (como <https://app.shade.inc> ). Esto es fundamental para que Shade acceda y descargue medios originales para ti desde nuestra app. Por [defecto](https://docs.wasabi.com/apidocs/operations-on-buckets#bucket-crossorigin-resource-sharing-cors-support), Wasabi tiene CORS configurado correctamente para permitir todos los orígenes. Sin embargo, si has cambiado o restringido tu origen, es necesario incluir en la lista blanca `*.shade.inc` como un origen permitido.

Puedes actualizar la configuración en el panel y aquí tienes el JSON correcto:

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

### Creación de claves de acceso

Shade accede a los buckets de Wasabi mediante el protocolo S3; esto significa que Shade requiere un nombre de bucket, una región de bucket, una clave de acceso y una clave secreta para poder acceder a este bucket.

Ve a Access Keys > Create Access Key y aprovisiona una clave de Root o Sub-User que tenga acceso al bucket que acabas de aprovisionar.

<figure><img src="https://440362858-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>

Asegúrate de haber descargado y copiado las claves al portapapeles

### Creación de una unidad BYOS en Shade

Al llegar a este punto, deberías haber obtenido correctamente los siguientes elementos:

1. Espacio de trabajo de Shade
2. Nombre del bucket
3. Región del bucket
4. Clave de acceso
5. Clave secreta

Si aún no tienes un espacio de trabajo, puedes crear uno [aquí](https://app.shade.inc).

Dentro de tu espacio de trabajo de Shade, ahora puedes crear una unidad. Selecciona el botón más junto a “My drives” > BYOS drive.

<figure><img src="https://440362858-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>

#### Selecciona una plantilla

<figure><img src="https://440362858-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>

Nuestras plantillas te ayudan a configurarte rápidamente con Shade, con metadatos y vistas adicionales que te ayudan a organizar tus archivos y recursos. Para obtener más información sobre nuestra IA, puedes consultar nuestra [academia](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). En este caso, hemos seleccionado Producción de video.

#### Creando nuestra unidad de Wasabi

A continuación, decidimos el nombre de nuestra unidad y seleccionamos nuestro proveedor Wasabi.

<figure><img src="https://440362858-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>

#### Añadiendo nuestras credenciales de Wasabi

A partir de los pasos anteriores, añadimos nuestras credenciales de Wasabi, incluidos nuestro nombre de bucket, región, clave de acceso y clave secreta.

{% hint style="info" %}
Este tiene que ser el nombre del bucket que creaste en Wasabi. No es el mismo que el nombre de la unidad que creaste en la pantalla anterior.
{% endhint %}

<figure><img src="https://440362858-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>

### Subiendo tu primer archivo

Una vez que hayas seguido los pasos anteriores, ya podrás subir tu primer archivo a tu unidad de Shade. Si se configuró correctamente, deberías poder subir tu archivo y montar la unidad de Shade en tu ordenador desde la [Aplicación de escritorio de Shade](https://shade.inc/download)

<figure><img src="https://440362858-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>

### Consejos de solución de problemas

Si tienes más preguntas, no dudes en contactarnos en <support@shade.inc> o unirte a nuestro [Discord](https://discord.gg/h8wqFMJ4vK).

#### No puedo subir, ¿qué está pasando?

Si no puedes subir archivos, revisa la configuración de CORS de tu bucket o tus claves secreta/de acceso y los permisos asociados.


---

# 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-es/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.
