> 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

## **Vue d'ensemble**

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 sur le cache**

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

## **Gestion de l'emplacement**

Vous pouvez changer l'emplacement où ShadeFS stocke son cache vers un dossier sur votre machine ou un périphérique externe :

1. Ouvrez **Paramètres > ShadeFS > Gestion du cache** dans l'application de bureau Shade (dans la version 2.3.21 et antérieure de l'application de bureau, ouvrez **Paramètres > ShadeFS > Configuration** à la place)
2. Sous **Paramètres du cache**, cliquez sur le **répertoire du cache ShadeFS** champ
3. Sélectionnez le répertoire de cache de votre choix

ShadeFS redémarre en arrière-plan après que vous avez changé l'emplacement du cache.

Pour des performances optimales, nous vous 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.

Parce que ShadeFS utilise des fichiers clairsemés pour les fichiers de cache, votre disque de cache doit être formaté en APFS (macOS), NTFS ou ReFS (Windows), ou ext4, XFS ou Btrfs (Linux). Les disques formatés en exFAT ou Mac OS étendu (HFS+) ne peuvent pas être utilisés pour le cache.

Changer le répertoire du cache déplace les données de vos fichiers mis en cache. ShadeFS conserve sa base de données des lecteurs et un petit index de ce qui est en cache dans le `.shade` dossier de votre répertoire personnel, donc laissez aussi un peu d'espace libre sur votre disque système.

<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>

## **Taille du cache**

La taille du cache peut être modifiée avec le **Taille du cache (Go)** paramètre dans **Paramètres > ShadeFS > Gestion du cache**, ou via **Modifier la taille du cache** dans le panneau « Mount Drives ». La taille minimale du cache est de 1 Go. 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 dans l'emplacement défini 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 vous avez plusieurs lecteurs montés en même temps, ils partageront tous le même espace de cache.

<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>

## **Comment ShadeFS libère automatiquement de l'espace**

Toutes les 5 minutes, ShadeFS vérifie l'espace de cache qu'il utilise. S'il dépasse la taille de votre cache, il supprime les fichiers que vous avez utilisés le moins récemment jusqu'à ce que le cache redescende à 90 % de votre limite.

* **Des fichiers entiers sont supprimés, jamais des parties de fichiers.** Définissez une taille de cache supérieure au plus gros fichier avec lequel vous travaillez, sinon ce fichier sera sans cesse supprimé puis retéléchargé.
* **Le cache peut brièvement dépasser votre limite.** Comme le nettoyage s'exécute toutes les quelques minutes, une utilisation intensive peut faire dépasser la taille de votre cache jusqu'au prochain passage.
* **Certains fichiers ne sont jamais supprimés automatiquement :** les fichiers épinglés, les fichiers que vous avez ouverts dans la dernière minute ou que vous êtes encore en train de lire, les fichiers en cours d'envoi et les fichiers dont les modifications ne sont pas encore synchronisées.
* **Les anciennes copies sont supprimées quelle que soit leur taille.** Les copies en cache de fichiers qui ne se trouvent plus sur aucun lecteur, comme des fichiers supprimés ou des versions antérieures d'un fichier qui a été remplacé, sont supprimées lors du prochain passage.

## **Alertes de cache et d'espace disque**

L'application de bureau vous avertit lorsque l'espace devient insuffisant. Cliquez sur la notification pour ouvrir **Gestion du cache**.

* **Le cache Shade est presque plein / Le cache Shade est plein**: votre cache est proche de sa taille maximale ou l'a atteinte. Shade supprime automatiquement les fichiers plus anciens, mais les fichiers en cours d'envoi ou ouverts ne peuvent pas être supprimés tant qu'ils ne sont pas terminés. Si cela continue à se produire, augmentez la taille de votre cache.
* **L'espace disque est faible / Le disque est presque plein**: le disque qui contient votre cache manque d'espace. Lorsqu'il est presque plein, les fichiers qui ne sont pas déjà en cache peuvent ne pas s'ouvrir, et les écritures sur le lecteur monté sont mises en pause jusqu'à ce que de l'espace se libère.

## **Libérer de l'espace de cache**

La **Gestion du cache** page indique quelle partie de votre cache est utilisée et vous permet de le nettoyer :

* **Utilisation** indique quelle part de la taille de votre cache est utilisée, ainsi que l'espace disque occupé par vos fichiers épinglés.
* **Peut être supprimé en toute sécurité** répertorie les fichiers en cache que vous pouvez supprimer. Cliquez sur **Supprimer** à côté d'un fichier pour supprimer uniquement ce fichier, ou **Tout effacer** (puis **Confirmer tout effacer**) pour les supprimer tous.
* **Épinglé** répertorie vos fichiers épinglés. Cliquez sur **Désépingler** à côté d'un fichier, ou **Tout désépingler**. Le désépinglage d'un fichier supprime également sa copie en cache.
* **En cours d'utilisation** répertorie les fichiers en cours d'envoi ou dont les modifications ne sont pas synchronisées. Ceux-ci ne peuvent pas être supprimés.
* **Non liés** répertorie les fichiers laissés par des lecteurs qui ne se trouvent plus sur cette machine. Cliquez sur **Effacer** pour les supprimer.
* **Zone dangereuse > Réinitialisation complète**: **Effacer tous les caches et réinitialiser** arrête ShadeFS et supprime tout ce qui se trouve dans le cache, y compris les épingles et les modifications non synchronisées. N'utilisez cela qu'en dernier recours.

## **Accès hors ligne**

Pour les situations où vous avez besoin d'un accès garanti à des fichiers spécifiques sans accès à Internet, vous pouvez épingler des fichiers hors ligne. Lorsque vous épinglez un fichier ou un dossier, ShadeFS télécharge une copie complète et la conserve dans votre répertoire de cache, la rendant disponible hors ligne. Les fichiers épinglés ne sont pas comptabilisés dans la limite de taille de votre cache, ce qui signifie que l'épinglage ne tient pas compte de l'espace de stockage disponible sur votre machine. Si vous essayez d'épingler plus de données que l'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. Cliquez avec le bouton droit sur l'élément
3. Sélectionnez « Épingler au cache »

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

## **Considérations de performance**

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 disque 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 importantes peuvent améliorer les performances avec les fichiers fréquemment consultés, elles nécessitent également 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 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/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.
