Community-Lösung

Nach der Deinstallation von CasaOS aufräumen, ohne bestehende Samba-Freigaben zu beeinträchtigen

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.

Der Quellthread besteht nur aus einem Beitrag, aber das darin beschriebene Problem ist wichtig: Ein Benutzer installierte CasaOS unter Linux, entfernte CasaOS später mit dem offiziellen Deinstallationsbefehl und stellte anschließend fest, dass seine frühere Samba-Konfiguration nicht mehr funktionierte. Eine Untersuchung ergab, dass die ursprüngliche smb.conf bei der Installation von CasaOS umbenannt worden war, während die von CasaOS erzeugte Samba-Konfiguration nach der Deinstallation weiterhin aktiv blieb.

Da der Thread keine Antwort des Supports und keine vollständige Übersicht der Bereinigung enthält, sollte die Seite eng gefasst bleiben. Sie kann den bestätigten Samba-Nebeneffekt erklären und eine sichere Methode zur Überprüfung nach der Deinstallation nennen, sollte aber keine definitive Liste aller Dateien erfinden, die CasaOS auf jeder Linux-Distribution hinterlässt.

Was tatsächlich bestätigt wurde

Der Benutzer hatte bereits vor CasaOS Samba-Freigaben eingerichtet. Diese Freigaben funktionierten mit Kodi auf einem Fernseher. Einige Tage nach der Deinstallation von CasaOS konnte Kodi nicht mehr darauf zugreifen.

Der Benutzer stellte anschließend fest, dass die Installation von CasaOS die ursprüngliche Samba-Konfiguration verschoben oder umbenannt und eine eigene Konfiguration installiert hatte. Der Deinstallationsvorgang stellte die vorherige smb.conf nicht automatisch wieder her, sodass der Rechner weiterhin die Konfiguration aus der CasaOS-Zeit verwendete.

Eine Anwendung zu deinstallieren ist nicht dasselbe wie ein Zurücksetzen des Hosts

CasaOS läuft auf einer Linux-Distribution und integriert sich in Dienste wie Docker, Speicherpfade und Samba. Wenn die Installation eine Konfigurationsdatei ersetzt oder verändert, stellt das Entfernen der CasaOS-Binärdateien den Host nicht zwangsläufig exakt so wieder her, wie er vor der Installation war.

Dies ist ein allgemeines Prinzip der Linux-Administration: „Paket entfernt“ und „System auf die vorherige Konfiguration zurückgesetzt“ sind unterschiedliche Vorgänge.

Der aktuelle CasaOS-Deinstaller bietet optionale Entfernungsschritte

Das von IceWhale gepflegte CasaOS-Projekt stellt casaos-uninstall weiterhin als normalen Deinstallationsbefehl bereit. Der aktuelle Deinstaller fragt separat, ob Docker, CasaOS-Container und CasaOS-Dateien entfernt werden sollen.

Sehen Sie sich vor der Deinstallation eines modernen Systems den aktuellen CasaOS-Entfernungsweg an, da sich die genauen Abfragen und das Bereinigungsverhalten zwischen den Versionen ändern können.

Vor der Deinstallation die Konfiguration auf Host-Ebene sichern

Wenn CasaOS auf einem Server getestet wird, auf dem bereits Dienste laufen, sollten Sie vor der Entfernung Kopien wichtiger Host-Konfigurationen speichern. Dazu gehören beispielsweise:

  • Samba-Konfiguration und Definitionen der Freigaben;
  • eigene systemd-Units;
  • Konfiguration eines Reverse-Proxys;
  • Docker-Compose-Dateien, die nicht von CasaOS verwaltet werden;
  • Firewall- oder Netzwerkkonfiguration;
  • Mount-Definitionen und Speicherkonfiguration.

Dies ist besonders wichtig auf einem „echten“ Linux-Server, auf dem CasaOS nicht die einzige Arbeitslast ist.

Samba durch den Vergleich bekanntermaßen funktionierender Dateien wiederherstellen

Wenn eine smb.conf aus der Zeit vor CasaOS noch unter einem umbenannten oder als Sicherung angelegten Dateinamen vorhanden ist, sollten Sie die aktive Konfiguration nicht einfach sofort überschreiben. Bewahren Sie zunächst beide Versionen auf, vergleichen Sie die Definitionen der Freigaben und überprüfen Sie die gewünschte Konfiguration.

Ein Syntaxfehler kann alle Samba-Freigaben außer Betrieb setzen. Verwenden Sie nach Möglichkeit die eigenen Konfigurationsprüfwerkzeuge von Samba, bevor Sie den Dienst neu starten oder neu laden.

/DATA oder Docker-Speicher nicht ohne Prüfung als „Bereinigung“ löschen

CasaOS speichert Anwendungs- und Benutzerdaten absichtlich an persistenten Speicherorten, damit bei der Deinstallation der Verwaltungsebene nicht automatisch Benutzerdaten zerstört werden. Nach der Entfernung kann dieselbe Sicherheitsmaßnahme wie ein „Überbleibsel“ wirken.

Löschen Sie /DATA, Docker-Volumes, Containerdaten oder Anwendungsordner nicht rekursiv, bevor Sie festgestellt haben, welche Dateien zu CasaOS gehören und welche von weiterhin benötigten Anwendungen verwendet werden.

Eine sichere Prüfung nach der Deinstallation

  1. Stellen Sie sicher, dass keine CasaOS-Dienste mehr laufen.
  2. Überprüfen Sie die aktive Samba-Konfiguration und vergleichen Sie sie mit Sicherungen aus der Zeit vor CasaOS.
  3. Listen Sie die verbleibenden CasaOS-Container auf, bevor Sie Docker-Daten löschen.
  4. Untersuchen Sie persistente Datenverzeichnisse, anstatt sie nur anhand ihres Namens zu löschen.
  5. Prüfen Sie, ob ein Dienst auf Host-Ebene weiterhin auf von CasaOS erstellte Dateien verweist.
  6. Entfernen Sie Überreste erst, nachdem Sie bestätigt haben, dass sie von keinen anderen Diensten benötigt werden.

Was der Quellthread nicht belegt

Der Beitrag belegt nicht, dass jede CasaOS-Deinstallation Samba zurücklässt, listet nicht jede verbleibende Datei auf und enthält keine Antwort von IceWhale dazu, ob dieses Verhalten als Fehler betrachtet wurde. Die enger gefasste bestätigte Tatsache lautet: Die zuvor vorhandene Samba-Konfiguration dieses Benutzers wurde nicht automatisch wiederhergestellt.

FAQ zur Bereinigung nach der CasaOS-Deinstallation

Entfernt casaos-uninstall zwangsläufig Docker?

Nein. Der gepflegte Deinstaller behandelt die Entfernung von Docker als separate Auswahl.

Warum funktionierten die alten Samba-Freigaben des Benutzers nicht mehr?

Die aktive smb.conf blieb die von CasaOS erstellte Version, anstatt auf die Konfiguration aus der Zeit vor CasaOS zurückgesetzt zu werden.

Sollte ich nach der Deinstallation jedes Verzeichnis löschen, das nach CasaOS aussieht?

Nein. Persistente Verzeichnisse können Anwendungs- oder Benutzerdaten enthalten, die bei der Deinstallation absichtlich nicht gelöscht wurden.