コミュニティソリューション

既存の Samba 共有を壊さずに CasaOS をアンインストールした後のクリーンアップ

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.

このスレッドは投稿1件のみですが、そこで説明されている問題は重要です。あるユーザーがLinuxにCasaOSをインストールし、後から公式のアンインストールコマンドでCasaOSを削除したところ、CasaOS導入前から使用していたSambaの設定が機能しなくなっていることに気付きました。調査の結果、CasaOSのインストール時に元のsmb.confの名前が変更され、CasaOSが生成したSamba設定がアンインストール後も有効なままになっていたことが分かりました。

このスレッドにはスタッフからの返信も、完全なクリーンアップ対象一覧もありません。そのため、このページの内容は限定的にする必要があります。確認済みのSambaへの影響と、アンインストール後に安全に監査する方法は説明できますが、すべてのLinuxディストリビューションでCasaOSが残すファイルの確定的な一覧を推測で示してはいけません。

実際に確認された問題

このユーザーは、CasaOSを導入する前からSamba共有を設定していました。その共有はテレビのKodiで正常に機能していました。しかし、CasaOSをアンインストールして数日後、Kodiから共有にアクセスできなくなりました。

その後、ユーザーはCasaOSのインストール時に元のSamba設定が移動または改名され、CasaOS独自の設定がインストールされていたことを発見しました。アンインストール処理では、以前のsmb.confが自動的に復元されなかったため、マシンはCasaOS導入時の設定を使い続けていました。

アプリケーションのアンインストールは、ホストのロールバックと同じではない

CasaOSはLinuxディストリビューション上で動作し、Docker、ストレージパス、Sambaなどのサービスと連携します。インストールによって設定ファイルが置き換えられたり変更されたりした場合、CasaOSのバイナリを削除しても、ホストがインストール前とまったく同じ状態に自動的に戻るとは限りません。

これはLinux管理における一般的な原則です。「パッケージを削除すること」と「システムを以前の設定に復元すること」は別の作業です。

現在のCasaOSアンインストーラーには、削除対象を選択する項目がある

IceWhaleが保守しているCasaOSプロジェクトでは、通常の削除コマンドとして引き続きcasaos-uninstallが提供されています。現在のアンインストーラーでは、Docker、CasaOSコンテナ、CasaOSファイルを削除するかどうかを個別に尋ねられます。

最新のシステムをアンインストールする前に、現在のCasaOSの削除手順を確認してください。リリースによって、表示される確認項目やクリーンアップの動作が変わる可能性があるためです。

アンインストール前に、ホストレベルの設定をバックアップする

すでにサービスが稼働しているサーバーでCasaOSを試している場合は、削除前に重要なホスト設定のコピーを保存してください。たとえば、次のようなものです。

  • Sambaの設定と共有定義
  • カスタムsystemdユニット
  • リバースプロキシの設定
  • CasaOSが所有していないDocker Composeファイル
  • ファイアウォールまたはネットワークの設定
  • マウント定義とストレージ設定

CasaOSだけが稼働しているのではない「実運用」のLinuxサーバーでは、これは特に重要です。

既知の正常なファイルと比較してSambaを復元する

CasaOS導入前のsmb.confが、名前を変更されたファイルやバックアップファイルとして残っている場合でも、すぐにアクティブな設定を上書きしないでください。まず両方のバージョンを保存し、共有定義を比較して、使用する設定が正しいか検証してください。

構文エラーによって、すべてのSamba共有が利用できなくなる可能性があります。可能であれば、サービスを再起動または再読み込みする前に、Samba独自の設定検証ツールを使用してください。

確認せずに「クリーンアップ」として/DATAやDockerストレージを削除しない

CasaOSは、管理レイヤーをアンインストールしてもユーザーデータが自動的に破棄されないよう、アプリケーションデータやユーザーデータを永続的な場所に保存します。この安全設計が、削除後には「残骸」のように見えることがあります。

どのファイルがCasaOSに属し、どのファイルが引き続き必要なアプリケーションに属しているかを確認するまでは、/DATA、Dockerボリューム、コンテナデータ、アプリケーションフォルダーを再帰的に削除しないでください。

アンインストール後に安全に監査する方法

  1. CasaOSのサービスが動作していないことを確認します。
  2. 有効なSamba設定を確認し、CasaOS導入前のバックアップと比較します。
  3. Dockerデータを削除する前に、残っているCasaOSコンテナを一覧表示します。
  4. 永続データディレクトリを名前だけで削除せず、内容を確認します。
  5. ホストレベルのサービスが、CasaOSによって作成されたファイルを引き続き参照していないか確認します。
  6. 他のサービスに必要ないことを確認してから、残存ファイルを削除します。

元のスレッドからは確定できないこと

この投稿から、CasaOSのアンインストールで必ずSambaの設定が残るとは言えません。また、残存するすべてのファイルの一覧も、IceWhaleがこの動作をバグと認識していたかどうかについての回答もありません。確認できる事実は、あくまでこのユーザーの既存のSamba設定が自動的には復元されなかったという点です。

CasaOSアンインストールのクリーンアップに関するよくある質問

casaos-uninstallを実行すると、必ずDockerも削除されますか?

いいえ。保守対象のアンインストーラーでは、Dockerの削除は別の選択項目になっています。

なぜユーザーの古いSamba共有は機能しなくなったのですか?

有効なsmb.confがCasaOSによって作成されたバージョンのままになり、CasaOS導入前の設定に戻らなかったためです。

アンインストール後、CasaOSらしい名前のディレクトリをすべて削除すべきですか?

いいえ。永続ディレクトリには、アンインストールによって意図的に削除されなかったアプリケーションデータやユーザーデータが含まれている場合があります。