Lorsque l’application Fichiers de ZimaOS affiche Erreur de chargement, mais que l’accès SMB depuis Windows fonctionne toujours, ne supposez pas immédiatement que le RAID ou les données ont disparu. C’était le cas dans cette discussion de février 2026 : l’interface Fichiers a cessé de fonctionner après la mise à jour 1.5.4, tandis que les autres applications et l’accès aux fichiers via Samba restaient opérationnels.
Le personnel d’IceWhale a ensuite apporté la précision la plus importante concernant la cause. raller1028 a indiqué que, dans ZimaOS 1.5.4, lorsque le disque système est plein, le service Fichiers peut cesser de fonctionner correctement. La procédure officielle consistait à libérer de l’espace sur le disque système, puis à redémarrer icewhale-files. Une solution de contournement communautaire distincte, consistant à renommer la base de données, a aidé plusieurs utilisateurs, mais IceWhale ne l’a pas présentée comme la première mesure à prendre.
Un accès SMB fonctionnel indique fortement que les données et les points de montage existent toujours
L’auteur de la discussion pouvait toujours accéder aux fichiers via un partage Samba depuis Windows. Cela signifie que le stockage hôte et le chemin d’accès aux données fonctionnaient encore, même si l’application web Fichiers ne pouvait pas les afficher.
Il est important de distinguer :
- la perte du stockage ou des données ;
- la défaillance du service Fichiers ;
- la défaillance du navigateur ou de l’interface utilisateur.
Fichiers n’est pas un conteneur Docker classique de l’App Store
Par conséquent, il est normal que docker ps n’affiche aucun conteneur Fichiers. Redémarrer des conteneurs Docker au hasard ne réparera pas le service Fichiers natif.
IceWhale a identifié le manque d’espace sur le système comme la cause du problème dans la version 1.5.4
Le 26 février, raller1028, membre du personnel d’IceWhale, a écrit que le problème « devrait être » dû au fait que le disque système était plein dans la version 1.5.4.
La procédure officielle de récupération était la suivante :
- libérer de l’espace sur le disque système depuis la ligne de commande ;
- redémarrer le service Fichiers :
systemctl restart icewhale-filesIl a été conseillé aux utilisateurs peu familiarisés avec le nettoyage en ligne de commande de contacter l’assistance plutôt que de supprimer des fichiers au hasard.
Pourquoi un disque système plein peut interrompre Fichiers alors que SMB fonctionne toujours
Les services natifs ont besoin d’espace de travail pour leurs bases de données, leur état, leurs fichiers temporaires, leurs journaux ou leurs opérations internes. Les grandes quantités de données utilisateur peuvent rester intactes sur un autre ensemble de stockage, tandis qu’une petite partition système atteint 100 % d’utilisation et provoque une défaillance propre à un service.
C’est pourquoi vérifier uniquement que « mon RAID dispose d’espace libre » ne suffit pas.
Conservez les données croissantes des applications en dehors du disque système
La documentation actuelle de ZimaOS recommande de déplacer les données des applications vers un espace de stockage réel, au lieu de laisser les bases de données Docker, les miniatures et les caches remplir le disque système.
Consultez les recommandations actuelles de ZimaOS concernant le stockage des applications pour éviter une autre source de saturation du disque système.
Le renommage de files.db a fonctionné pour plusieurs utilisateurs
Un membre de la communauté a ensuite publié :
mv /var/lib/casaos_data/.casaos/files.db /var/lib/casaos_data/.casaos/files.db.bak
systemctl restart icewhale-filesPlusieurs participants ont répondu que cela avait rétabli Fichiers.
Cette méthode doit toutefois être considérée comme une procédure de récupération communautaire secondaire. Le personnel d’IceWhale a immédiatement demandé quelle était l’importance de la suppression de la base de données Fichiers et n’a pas remplacé les instructions officielles — « libérer de l’espace système, puis redémarrer le service » — par cette commande.
Renommer une base de données est plus sûr que la supprimer, mais cela modifie tout de même l’état de l’application
La commande communautaire conserve une copie .bak au lieu d’effacer la base de données. C’est préférable pour pouvoir revenir en arrière, mais la reconstruction de la base de données Fichiers peut modifier les métadonnées indexées ou d’autres éléments de l’état du service.
Ne l’utilisez pas comme première mesure lorsque le disque système est simplement plein.
Ne supposez pas que le problème de la version 1.5.4 persiste dans la version actuelle de ZimaOS
La version actuelle de ZimaOS est la 1.7.x et continue de recevoir des correctifs concernant Fichiers, le stockage, la mémoire, la sécurité et le stockage des applications. Cet incident historique est utile parce qu’il montre comment distinguer une défaillance de service d’une perte de données, et non parce que toutes les erreurs modernes de Fichiers ont la même cause.
Si le problème réapparaît aujourd’hui, commencez par relever l’espace libre actuel du système, la version actuelle, l’état du service et le bon fonctionnement ou non de l’accès SMB ou d’autres méthodes d’accès aux fichiers.
Libérez de l’espace de manière réfléchie
N’exécutez pas de scripts de nettoyage généraux sur des répertoires système dont vous ignorez le contenu. Identifiez les caches d’applications, les données Docker, les sauvegardes ou les journaux volumineux, puis utilisez autant que possible les outils actuels de nettoyage ou de migration de ZimaOS.
FAQ : erreur de chargement de Fichiers
L’accès SMB fonctionnait-il toujours dans le cas présenté ?
Oui, ce qui indiquait fortement que les données et les points de montage étaient toujours présents.
Quelle cause du problème de la version 1.5.4 le personnel d’IceWhale a-t-il identifiée ?
Un disque système plein qui empêchait le service Fichiers de fonctionner correctement.
Quelle était la commande officielle pour redémarrer le service ?
systemctl restart icewhale-files.
Le renommage de files.db constituait-il la recommandation officielle de première intention ?
Non. Il s’agissait d’une solution de contournement communautaire confirmée par plusieurs utilisateurs, tandis que la recommandation initiale d’IceWhale consistait à libérer de l’espace et à redémarrer le service Fichiers.
