> 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/guide-de-depannage-de-shadefs.md).

# Guide de dépannage de ShadeFS

### Problèmes de performance

#### 1. Optimiser la configuration du cache

**Problème :** Accès aux fichiers et performances de lecture lents

**Solutions :**

* **Utiliser un SSD externe** - Connectez un SSD dédié (Samsung T7 recommandé) pour le stockage du cache au lieu d’utiliser le stockage interne
* **Augmenter la taille du cache** - La valeur par défaut de 10 Go peut être insuffisante pour les projets plus importants. Allouez en fonction de la taille de votre ensemble de travail habituel. Nous recommandons d’avoir une taille de cache au moins aussi grande que le plus grand fichier avec lequel vous travaillez afin d’éviter toute éviction/re-téléchargement continus
* **Vérifier le format du disque** - Assurez-vous que le disque de cache est formaté en APFS (Mac) ou en NTFS (Windows). N’utilisez pas exFAT

#### 2. Vérifier les exigences réseau

**Problème :** Lecture saccadée ou chargement lent des fichiers

**Solutions :**

* **Vérifier la vitesse Internet** - Un débit descendant minimum de 500 Mbit/s est recommandé pour le contenu 4K
* **Utiliser une connexion filaire** - Passez du Wi‑Fi à Ethernet lors de l’édition de ressources non proxy
* **Tester la stabilité de la connexion** - Assurez-vous qu’il n’y a aucune perte de paquets ou coupures intermittentes pendant les sessions actives

#### 3. Utiliser des workflows proxy

**Problème :** Le contenu haute résolution offre de mauvaises performances

**Solutions :**

* **Activer les fichiers proxy** - Travaillez avec des proxys plutôt qu’avec les fichiers haute résolution d’origine, surtout pour le contenu 4K et plus
* **Idéal pour une bande passante limitée** - Améliore considérablement les performances avec une connexion inférieure à 500 Mbit/s

#### 4. Gérer l’épinglage et l’utilisation du montage

**Problème :** L’épinglage échoue ou ralentit pendant le travail actif

**Solutions :**

* **Éviter les opérations simultanées** - N’épinglez pas de grandes quantités de données tout en accédant activement aux fichiers via le montage
* **Séparer les workflows** - Terminez les opérations d’épinglage avant une utilisation intensive du montage
* **Remarque :** Les mises à jour récentes ont corrigé des bugs où l’épinglage pouvait échouer lors des tentatives de nouvelle connexion réseau

#### 5. Surveiller l’espace du disque de cache

**Problème :** Dégradation inattendue des performances

**Solutions :**

* **Vérifier l’espace libre** - Assurez-vous de disposer d’un espace suffisant sur votre disque de cache
* **Ajuster l’allocation à la bonne taille** - Adaptez la taille du cache aux besoins réels de votre ensemble de travail

### Obtenir une aide supplémentaire

Si les problèmes persistent après avoir essayé ces étapes :

1. Allez dans Paramètres dans l’application ShadeFS
2. Exporter « ShadeFS Logs »
3. Partagez les journaux avec l’assistance pour enquête


---

# 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/guide-de-depannage-de-shadefs.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.