Solution communautaire

Nettoyer après la désinstallation de CasaOS sans casser les partages Samba existants

An October 2025 report where uninstalling CasaOS from Linux left the CasaOS-created Samba configuration active while the user's pre-existing smb.conf had been renamed, breaking Kodi access to shares that existed before CasaOS.

Le fil source ne comporte qu'une seule publication, mais le problème qu'il décrit est important : un utilisateur a installé CasaOS sous Linux, puis l'a supprimé avec la commande officielle de désinstallation, avant de découvrir que sa configuration Samba antérieure à CasaOS ne fonctionnait plus. L'enquête a montré que le fichier smb.conf d'origine avait été renommé lors de l'installation de CasaOS, tandis que la configuration Samba générée par CasaOS était restée active après la désinstallation.

Comme le fil ne contient ni réponse du personnel ni inventaire complet des éléments à nettoyer, la page appropriée doit rester ciblée. Elle peut expliquer l'effet secondaire confirmé sur Samba et proposer une méthode d'audit sûre après la désinstallation, mais elle ne doit pas inventer une liste définitive de tous les fichiers que CasaOS laisse sur chaque distribution Linux.

Ce qui a été réellement confirmé

L'utilisateur disposait de partages Samba avant CasaOS. Ils fonctionnaient avec Kodi sur un téléviseur. Quelques jours après la désinstallation de CasaOS, Kodi ne pouvait plus y accéder.

L'utilisateur a ensuite découvert que l'installation de CasaOS avait déplacé ou renommé la configuration Samba d'origine et installé sa propre configuration. Le processus de désinstallation n'a pas automatiquement restauré l'ancien smb.conf ; la machine a donc continué à utiliser la configuration de l'époque de CasaOS.

Désinstaller une application ne revient pas à restaurer l'hôte

CasaOS fonctionne au-dessus d'une distribution Linux et s'intègre à des services tels que Docker, les chemins de stockage et Samba. Si l'installation remplace ou modifie un fichier de configuration, la suppression des fichiers binaires de CasaOS ne reconstruit pas nécessairement l'hôte exactement comme il était avant l'installation.

Il s'agit d'un principe général de l'administration Linux : « paquet supprimé » et « système restauré à sa configuration précédente » sont deux opérations différentes.

Le programme de désinstallation actuel de CasaOS propose des options de suppression

Le projet CasaOS maintenu par IceWhale expose toujours casaos-uninstall comme commande de suppression standard. Le programme de désinstallation actuel demande séparément s'il faut supprimer Docker, les conteneurs CasaOS et les fichiers CasaOS.

Consultez la procédure actuelle de suppression de CasaOS avant de désinstaller un système moderne, car les invites exactes et le comportement de nettoyage peuvent varier selon les versions.

Avant la désinstallation, sauvegardez la configuration de l'hôte

Si CasaOS est testé sur un serveur qui héberge déjà des services, enregistrez des copies des principales configurations de l'hôte avant la suppression. Cela peut notamment inclure :

  • la configuration Samba et les définitions des partages ;
  • les unités systemd personnalisées ;
  • la configuration du proxy inverse ;
  • les fichiers Docker Compose qui ne sont pas gérés par CasaOS ;
  • la configuration du pare-feu ou du réseau ;
  • les définitions des points de montage et la configuration du stockage.

C'est particulièrement important sur un serveur Linux « réel » où CasaOS n'est pas la seule charge de travail.

Restaurez Samba en comparant les fichiers connus comme fonctionnels

Si un smb.conf antérieur à CasaOS existe encore sous un nom renommé ou dans un fichier de sauvegarde, ne remplacez pas immédiatement la configuration active. Préservez d'abord les deux versions, comparez les définitions des partages et validez la configuration souhaitée.

Une erreur de syntaxe peut mettre tous les partages Samba hors ligne. Si possible, utilisez les outils de validation de configuration de Samba avant de redémarrer ou de recharger le service.

Ne supprimez pas /DATA ni le stockage Docker comme « nettoyage » sans inspection

CasaOS stocke délibérément les données des applications et des utilisateurs dans des emplacements persistants afin que la désinstallation de la couche de gestion ne détruise pas automatiquement les données utilisateur. Après la suppression, cette protection peut donner l'impression qu'il reste des « fichiers résiduels ».

Ne supprimez pas récursivement /DATA, les volumes Docker, les données des conteneurs ou les dossiers d'applications avant d'avoir déterminé quels fichiers appartiennent à CasaOS et lesquels appartiennent aux applications dont vous avez encore besoin.

Un audit sûr après la désinstallation

  1. Vérifiez que les services CasaOS ne sont plus actifs.
  2. Examinez la configuration Samba active et comparez-la aux sauvegardes antérieures à CasaOS.
  3. Répertoriez les conteneurs CasaOS restants avant de supprimer des données Docker.
  4. Inspectez les répertoires de données persistantes au lieu de les supprimer en fonction de leur nom.
  5. Vérifiez si un service de l'hôte fait encore référence à des fichiers créés par CasaOS.
  6. Ne supprimez les éléments résiduels qu'après avoir confirmé qu'ils ne sont nécessaires à aucun autre service.

Ce que le fil source n'établit pas

La publication ne prouve pas que chaque désinstallation de CasaOS laisse Samba en place, ne répertorie pas tous les fichiers résiduels et ne contient pas de réponse d'IceWhale indiquant si ce comportement a été considéré comme un bogue. Le fait confirmé est plus limité : la configuration Samba préexistante de cet utilisateur n'a pas été restaurée automatiquement.

FAQ sur le nettoyage après la désinstallation de CasaOS

casaos-uninstall supprime-t-il forcément Docker ?

Non. Le programme de désinstallation maintenu traite la suppression de Docker comme une option distincte.

Pourquoi les anciens partages Samba de l'utilisateur ont-ils cessé de fonctionner ?

Le smb.conf actif est resté la version créée par CasaOS au lieu de revenir à la configuration antérieure à CasaOS.

Dois-je supprimer tous les répertoires qui ressemblent à des répertoires CasaOS après la désinstallation ?

Non. Les répertoires persistants peuvent contenir des données d'applications ou d'utilisateurs que la désinstallation n'a volontairement pas détruites.