> 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/shadefs/managing-the-shadefs-cache.md).

# Gestión de la caché de ShadeFS

## **Descripción general**

ShadeFS utiliza un sistema de caché local para permitir un acceso fluido y eficiente a tus archivos multimedia almacenados en la nube. Entiende cómo configurar y administrar esta caché para optimizar el rendimiento de tu flujo de trabajo y gestionar tu almacenamiento local.

## **Conceptos básicos de la caché**

De forma predeterminada, ShadeFS asigna 26 GB de espacio de caché en la `.shade` carpeta dentro del directorio raíz de usuario de tu computadora. Esta caché sirve como ubicación de almacenamiento temporal para segmentos multimedia transmitidos, de modo que tu explorador de archivos y tus NLE tengan acceso instantáneo a tus medios.

## **Administración de la ubicación**

Puedes cambiar dónde ShadeFS almacena su caché a una carpeta en tu máquina o a un dispositivo externo:

1. Abre **Configuración > ShadeFS > Administración de caché** en la aplicación de escritorio de Shade (en la versión 2.3.21 y anteriores de la aplicación de escritorio, abre **Configuración > ShadeFS > Configuración** en su lugar)
2. En **Configuración de caché**, haz clic en el **directorio de caché de ShadeFS** campo
3. Selecciona el directorio de caché que prefieras

ShadeFS se reinicia en segundo plano después de que cambias la ubicación de la caché.

Para un rendimiento óptimo, recomendamos usar un SSD externo de alta velocidad (como un Samsung T7) como ubicación de tu caché. Esta configuración ofrecerá un mayor rendimiento y también mantendrá libre la unidad de tu sistema para otras operaciones.

Como ShadeFS usa archivos dispersos para los archivos de caché, tu unidad de caché debe estar formateada como APFS (macOS), NTFS o ReFS (Windows), o ext4, XFS o Btrfs (Linux). Las unidades formateadas como exFAT o Mac OS Extended (HFS+) no pueden usarse para la caché.

Cambiar el directorio de caché mueve los datos en caché de tus archivos. ShadeFS conserva su base de datos de unidades y un pequeño índice de lo que está en caché en la `.shade` carpeta en tu directorio de inicio, así que deja también un poco de espacio libre en tu unidad del sistema.

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FR9pi4tfHMp3hNKpRe4Q8%2FScreenshot%202026-01-08%20at%204.27.15%E2%80%AFPM.png?alt=media&#x26;token=174aadf7-1ba4-4a05-b8b8-ab4356655218" alt=""><figcaption></figcaption></figure>

## **Tamaño de caché**

El tamaño de la caché se puede cambiar con la **Tamaño de caché (GB)** configuración en **Configuración > ShadeFS > Administración de caché**, o mediante **Editar tamaño de caché** en el panel "Montar unidades". El tamaño mínimo de la caché es 1 GB. La caché predeterminada de 26 GB es suficiente para operaciones básicas, pero puedes aumentarla hasta el espacio libre disponible en tu computadora o en cualquier ubicación que tenga configurado tu directorio de caché. Ten en cuenta el tamaño típico de tus proyectos de flujo de trabajo y el almacenamiento disponible al ajustar esta configuración. El tamaño de la caché se comparte entre todas las unidades. Si tienes varias unidades montadas al mismo tiempo, todas compartirán el mismo espacio de caché.

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FxQcC7cEmkXvxO9uK2TWg%2FManageCacheSize.gif?alt=media&#x26;token=bbb3db9f-6d76-4565-b1ea-ee5e63c78757" alt=""><figcaption></figcaption></figure>

## **Cómo ShadeFS libera espacio automáticamente**

Cada 5 minutos, ShadeFS comprueba cuánto espacio de caché está utilizando. Si supera el tamaño de tu caché, elimina los archivos usados hace más tiempo hasta que la caché vuelva a quedar al 90 % de tu límite.

* **Se eliminan archivos completos, nunca partes de archivos.** Establece el tamaño de tu caché por encima del archivo más grande con el que trabajas, o ese archivo seguirá eliminándose y descargándose de nuevo.
* **La caché puede superar brevemente tu límite.** Como la limpieza se ejecuta cada pocos minutos, un uso intensivo puede llevar la caché por encima de tu tamaño de caché hasta la siguiente pasada.
* **Algunos archivos nunca se eliminan automáticamente:** archivos fijados, archivos que has abierto en el último minuto o que aún estás leyendo, archivos que se están subiendo y archivos con cambios que aún no se han sincronizado.
* **Las copias antiguas se limpian independientemente de su tamaño.** Las copias en caché de archivos que ya no están en ninguna unidad, como archivos eliminados o versiones anteriores de un archivo que ha sido reemplazado, se eliminan en la siguiente pasada.

## **Alertas de caché y espacio en disco**

La aplicación de escritorio te notifica cuando el espacio empieza a escasear. Haz clic en la notificación para abrir **Administración de caché**.

* **La caché de Shade está casi llena / La caché de Shade está llena**: tu caché está cerca o en el límite de su tamaño. Shade elimina automáticamente los archivos más antiguos, pero los archivos que se están subiendo o están abiertos no se pueden eliminar hasta que terminen. Si esto sigue ocurriendo, aumenta el tamaño de tu caché.
* **El espacio en disco se está agotando / El disco está casi lleno**: el disco que contiene tu caché se está quedando sin espacio. Cuando está casi lleno, los archivos que aún no están en caché pueden no abrirse, y las escrituras en la unidad montada se pausan hasta que se libere espacio.

## **Liberar espacio de caché**

La **Administración de caché** página muestra cuánto de tu caché está en uso y te permite limpiarla:

* **Uso** muestra cuánto de tu tamaño de caché está usado, además de cuánto espacio en disco ocupan tus archivos fijados.
* **Se puede borrar sin riesgo** enumera los archivos en caché que puedes eliminar. Haz clic en **Eliminar** junto a un archivo para borrar solo ese archivo, o **Borrar todo** (luego **Confirmar borrar todo**) para borrarlos todos.
* **Fijados** enumera tus archivos fijados. Haz clic en **Desfijar** junto a un archivo, o **Desfijar todo**. Desfijar un archivo también elimina su copia en caché.
* **En uso** enumera los archivos que se están subiendo o que tienen cambios no sincronizados. Estos no se pueden borrar.
* **Desvinculados** enumera los archivos dejados por unidades que ya no están en esta máquina. Haz clic en **Borrar** para eliminarlos.
* **Zona de peligro > Restablecimiento completo**: **Borrar todas las cachés y restablecer** detiene ShadeFS y elimina todo lo que hay en la caché, incluidos los pines y los cambios no sincronizados. Úsalo solo como último recurso.

## **Acceso sin conexión**

Para situaciones en las que necesites acceso garantizado a archivos específicos sin acceso a internet, puedes fijar archivos para uso sin conexión. Cuando fijas un archivo o carpeta, ShadeFS descarga una copia completa y la mantiene en tu directorio de caché, dejándola disponible sin conexión. Los archivos fijados no cuentan para el límite del tamaño de tu caché, lo que significa que fijar archivos no tiene en cuenta la cantidad de almacenamiento disponible en tu máquina. Si intentas fijar más almacenamiento del que tienes disponible, tu máquina se quedará sin espacio y experimentarás problemas. Para fijar contenido:

1. Navega hasta el archivo o carpeta deseado en la aplicación Shade
2. Haz clic derecho en el elemento
3. Selecciona "Fijar en caché"

Más información aquí: [Fijar archivos sin conexión](https://academy.shade.inc/shade-academy/shade-academy-es/shadefs/pinning-files-offline.md)

## **Consideraciones sobre el rendimiento**

La configuración de tu caché afecta directamente al rendimiento del sistema. Para la mejor experiencia:

* Usa un dispositivo de almacenamiento de alta velocidad para la ubicación de tu caché; para hardware recomendado, consulta [Cómo elegir un SSD externo para la caché de Shade](https://academy.shade.inc/shadefs/choosing-an-external-ssd-for-shade-cache)
* Asigna un tamaño de caché suficiente para tu conjunto de trabajo habitual
* Supervisa el espacio disponible en tu unidad de caché
* Considera fijar los archivos usados con frecuencia para un acceso constante

Recuerda que, aunque tamaños de caché más grandes pueden mejorar el rendimiento con archivos de acceso frecuente, también requieren más espacio de almacenamiento en tu sistema local.


---

# 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/shadefs/managing-the-shadefs-cache.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.
