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

# Gestion du cache ShadeFS

## **Aperçu**

ShadeFS utilise un système de cache local pour permettre un accès fluide et efficace à vos fichiers multimédias stockés dans le cloud. Comprenez comment configurer et gérer ce cache afin d’optimiser les performances de votre flux de travail et de gérer votre stockage local.

## **Notions de base du cache**

Par défaut, ShadeFS alloue 26 Go d’espace de cache dans le `.shade` dossier situé dans le répertoire racine utilisateur de votre ordinateur. Ce cache sert d’emplacement de stockage temporaire pour les segments multimédias diffusés en streaming afin que votre explorateur de fichiers et vos NLE aient un accès instantané à vos médias.

## **Gestion de l’emplacement**

Vous pouvez modifier l’emplacement où ShadeFS stocke son cache pour le déplacer vers un dossier sur votre machine ou vers un périphérique externe :

1. Ouvrez le menu Paramètres/Préférences dans votre application Shade
2. Accédez à la section des paramètres du cache
3. Sélectionnez le répertoire de cache de votre choix

Pour des performances optimales, nous recommandons d’utiliser un SSD externe haute vitesse (comme un Samsung T7) comme emplacement de cache. Cette configuration offrira de meilleures performances et laissera également votre disque système libre pour d’autres opérations.

Votre disque dur externe ne peut pas être formaté en exFAT, car nous utilisons des fichiers clairsemés pour les fichiers de cache. Veuillez formater votre disque en APFS ou NTFS

<figure><img src="/files/f627d46fbf4a0028e604a5e45477892ff08afbaf" alt=""><figcaption></figcaption></figure>

## **Taille du cache**

La taille du cache peut être modifiée via le panneau « Mount Drives », ou via **Paramètres > Préférences**. Le cache par défaut de 26 Go est suffisant pour les opérations de base, mais vous pouvez l’augmenter jusqu’à l’espace libre disponible sur votre ordinateur ou jusqu’à la capacité définie pour votre répertoire de cache. Tenez compte de la taille habituelle de vos projets et de l’espace de stockage disponible lorsque vous ajustez ces paramètres. La taille du cache est partagée entre tous les lecteurs. Si plusieurs lecteurs sont montés en même temps, ils partageront tous le même espace de cache.

<figure><img src="/files/a97e7b7d4773308650aba23adb0c44832c91ff9e" alt=""><figcaption></figcaption></figure>

## **Accès hors ligne**

Dans les situations où vous avez besoin d’un accès garanti à des fichiers spécifiques sans connexion Internet, vous pouvez épingler des fichiers hors ligne. Lorsque vous épinglez un fichier ou un dossier, une copie complète est téléchargée **à l’extérieur** de votre cache, ce qui le rend disponible hors ligne. Cela signifie que l’épinglage ne tient pas compte de l’espace de stockage disponible sur votre machine. Si vous essayez d’épingler plus de contenu que vous n’avez d’espace disponible, votre machine manquera d’espace et vous rencontrerez des problèmes. Pour épingler du contenu :

1. Accédez au fichier ou au dossier souhaité dans l’application Shade
2. Faites un clic droit sur l’élément
3. Sélectionnez « Épingler au cache »

Plus d’informations ici : [Épingler des fichiers hors ligne](/shade-academy/shade-academy-fr/shadefs/pinning-files-offline.md)

## **Considérations relatives aux performances**

La configuration de votre cache a un impact direct sur les performances du système. Pour une expérience optimale :

* Utilisez un périphérique de stockage à haute vitesse pour l’emplacement de votre cache ; pour du matériel recommandé, consultez [Choisir un SSD externe pour le cache Shade](https://academy.shade.inc/shadefs/choosing-an-external-ssd-for-shade-cache)
* Allouez une taille de cache suffisante pour votre ensemble de travail habituel
* Surveillez l’espace disponible sur votre lecteur de cache
* Envisagez d’épingler les fichiers fréquemment utilisés pour un accès constant

N’oubliez pas que, si des tailles de cache plus grandes peuvent améliorer les performances avec les fichiers fréquemment consultés, elles nécessitent aussi davantage d’espace de stockage sur votre système 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 dynamically by asking a question.

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

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/shadefs/managing-the-shadefs-cache.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
