Folzo
d1e12cff60
- Structure complète du projet - Docker compose de production - Documentation organisée par thèmes - Guides d'installation et configuration - Section dépannage détaillée - Journal historique
120 lines
2.9 KiB
Markdown
120 lines
2.9 KiB
Markdown
# 🔧 Dépannage - Index
|
|
|
|
## Vue d'ensemble
|
|
|
|
Cette section regroupe les problèmes courants rencontrés avec Effi et leurs solutions.
|
|
|
|
---
|
|
|
|
## Problèmes par catégorie
|
|
|
|
### 🖥️ [GPU AMD ROCm](./rocm-amd-gpu.md)
|
|
- `hipErrorInvalidDeviceFunction`
|
|
- `float16 not supported on CPU backend`
|
|
- Build CTranslate2 pour gfx1100
|
|
- ROCm non détecté
|
|
|
|
### 🌐 [Réseau et Ports](./reseau-et-ports.md)
|
|
- Conflits de ports
|
|
- Wake-on-LAN non fonctionnel
|
|
- Interface réseau qui tombe
|
|
- Erreurs de connexion entre machines
|
|
|
|
### 💾 Mémoire et Stockage
|
|
- Souvenirs qui ne s'enregistrent pas
|
|
- Souvenirs non injectés
|
|
- Erreurs SQLite
|
|
- Base CouchDB inaccessible
|
|
|
|
### 🐳 Docker
|
|
- Conteneurs qui redémarrent en boucle
|
|
- Erreurs de permissions
|
|
- Volumes non persistants
|
|
- Images qui ne buildent pas
|
|
|
|
### 🎤 Audio
|
|
- STT qui ne répond pas
|
|
- TTS silencieux
|
|
- Latence excessive
|
|
- Erreurs de transcription
|
|
|
|
---
|
|
|
|
## Diagnostic rapide
|
|
|
|
### Commandes de base
|
|
|
|
```bash
|
|
# Vérifier l'état des conteneurs
|
|
docker compose ps
|
|
|
|
# Voir les logs d'un service
|
|
docker compose logs [service]
|
|
|
|
# Vérifier l'utilisation des ressources
|
|
docker stats
|
|
|
|
# Tester les connexions réseau
|
|
curl http://192.168.1.27:3000 # OpenWebUI
|
|
curl http://192.168.1.11:11434/api/tags # Ollama
|
|
curl http://192.168.1.11:8200/v1/models # STT
|
|
curl http://192.168.1.11:8100/v1/models # TTS
|
|
```
|
|
|
|
### Logs importants
|
|
|
|
```bash
|
|
# Logs OpenWebUI (problèmes généraux)
|
|
docker logs open-webui --tail 100
|
|
|
|
# Logs avec filtre mémoire
|
|
docker logs open-webui --tail 50 | grep -iE "memory|saved|added"
|
|
|
|
# Logs speaches (STT)
|
|
docker logs speaches-stt
|
|
|
|
# Logs wol-proxy
|
|
docker logs wol-proxy
|
|
```
|
|
|
|
---
|
|
|
|
## Checklist de diagnostic
|
|
|
|
### Problème : Effi ne répond pas
|
|
|
|
- [ ] OpenWebUI est-il démarré ? `docker ps | grep open-webui`
|
|
- [ ] Ollama est-il accessible ? `curl http://192.168.1.11:11434/api/tags`
|
|
- [ ] Le PC Gaming est-il allumé ?
|
|
- [ ] Le wol-proxy fonctionne-t-il ? `docker logs wol-proxy`
|
|
|
|
### Problème : La mémoire ne fonctionne pas
|
|
|
|
- [ ] Auto Memory est-il activé globalement ?
|
|
- [ ] Memory Injection est-il activé globalement ?
|
|
- [ ] Le modèle qwen2.5:3b est-il disponible ?
|
|
- [ ] Y a-t-il des erreurs dans les logs ? `docker logs open-webui | grep -i memory`
|
|
|
|
### Problème : L'audio ne fonctionne pas
|
|
|
|
- [ ] speaches est-il démarré ? `docker ps | grep speaches`
|
|
- [ ] openedai-speech est-il démarré ?
|
|
- [ ] Les URLs dans OpenWebUI sont-elles correctes ?
|
|
- [ ] Test manuel : `curl http://192.168.1.11:8200/v1/models`
|
|
|
|
### Problème : ROCm/GPU
|
|
|
|
- [ ] ROCm est-il installé ? `rocm-smi --showproductname`
|
|
- [ ] La carte est-elle détectée ? `rocminfo | grep gfx`
|
|
- [ ] Les conteneurs utilisent-ils les bons devices ?
|
|
- [ ] L'architecture gfx est-elle correcte ?
|
|
|
|
---
|
|
|
|
## Ressources externes
|
|
|
|
- [Documentation OpenWebUI](https://docs.openwebui.com/)
|
|
- [Documentation Ollama](https://github.com/ollama/ollama/blob/main/docs/README.md)
|
|
- [Documentation ROCm AMD](https://docs.amd.com)
|
|
- [Documentation Qdrant](https://qdrant.tech/documentation/)
|