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

ZimaOSで設定ミスのあるNextcloudアプリをクリーン再インストール:コンテナと正しいAppDataのみを削除

A January 2026 thread where Nextcloud remained misconfigured after uninstall/reinstall because persistent configuration remained. Portainer container cleanup did not remove that state. A community reply told the user to uninstall the App Store container and manually remove the Nextcloud AppData folder; the original poster replied that it worked.

このソースでの修正が機能したのは、Nextcloudコンテナ永続的なAppDataという2つの異なるものを分けて扱ったためです。コンテナを削除して再作成しても、次回のインストール時にNextcloudが引き継ぐ設定はリセットされませんでした。古いAppDataも削除したところ、元の投稿者はクリーンインストールが正常に完了したことを確認しました。

だからといって、現在のユーザーがAppDataフォルダーを無条件に削除すべきという意味ではありません。NextcloudのAppDataには、パッケージの構成によって設定、データベースの状態、鍵、アプリケーションデータなどが含まれる場合があります。重要なデータをバックアップし、現在のホストボリュームのマッピングを確認したうえで、完全に初期状態から始めることが明確な目的である場合に限り、確認済みのNextcloud設定ツリーだけを削除してください。

コンテナを再インストールしてもNextcloudがリセットされなかった理由

Dockerコンテナは使い捨ての実行インスタンスです。ZimaOSは設定がアップグレードやコンテナの再作成後も保持されるよう、永続的なホストフォルダーをコンテナ内にマッピングします。

そのため、同じパッケージを再インストールすると、新しいコンテナが作成されても、直ちに同じ壊れた設定を読み込んでしまうことがあります。

Portainerでアプリを完全にクリーンアップできなかった理由

元のユーザーはPortainerを試しました。PortainerからDockerコンテナを削除しても、バインドマウントされたホストディレクトリがすべて自動的に削除されるわけではありません。AppDataの状態はコンテナのライフサイクル外に残っていました。

ソースで確認された復旧方法は、コンテナの削除とAppDataのクリーンアップの組み合わせ

コミュニティで示された手順は次のとおりです。

  1. ZimaOSのアプリストアからNextcloudをアンインストールする。
  2. 永続的なAppDataフォルダーを特定する。
  3. 必要になる可能性のあるデータをバックアップする。
  4. 完全にクリーンな再インストールを行う場合は、壊れたAppDataを削除する。
  5. Nextcloudを再度インストールする。

元の投稿者は「正常に動作した」と返信しており、この手順によってその特定の設定不備が解消されたことを確認しています。

通常のファイルUIからAppDataを書き込みできない場合がある

コミュニティの返信では、ソース環境のAppDataがシステムまたはroot所有だったため、通常のUIユーザーでは削除できなかったと説明されています。だからといって、広範囲にchmod -R 777を実行したり、AppDataツリー全体の所有権を変更したりするのは適切ではありません。

利用可能な場合は、現在サポートされているアプリデータまたはアンインストールの操作を使用してください。あるいは、対象アプリの正確なフォルダーだけに限定した管理者操作を行ってください。

現在のZimaOSでは、コンテナと永続的なホストパスが明確に分離されている

IceWhaleの現在のアプリストレージに関するドキュメントでは、アプリデータ、メディア、キャッシュの保存場所が説明されており、ホストとコンテナ間のボリュームマッピングを確認できます。

現在のZimaOSのアプリストレージモデルを使用してください。

Nextcloudは複数のコンテナで構成される場合がある

Nextcloudの一部のパッケージには、個別のデータベース、Redis、またはAIO管理のコンテナが含まれているか、依存している場合があります。複数コンテナ構成をトラブルシューティングする場合は、何かを削除する前に、永続化されているすべてのデータベースおよび設定パスを特定してください。

Nextcloudのフォルダーを1つ削除すれば、外部のPostgreSQLまたはMariaDBデータベースも自動的にリセットされるとは限りません。

破壊的な手順であることを明確にする

古いNextcloudインスタンスに、必要になる可能性のあるファイル、ユーザー、共有設定、暗号化キー、データベースの状態が含まれている場合は、クリーンアップの前にコピーまたはエクスポートしてください。「新規インストール」と「以前のインスタンスの復旧」は正反対の目的です。

Nextcloudのクリーン再インストールに関するFAQ

アンインストールして再インストールするだけで、ソースの問題は解決しましたか?

いいえ。永続的なAppDataに設定不備が残っていました。

AppDataを削除することで、ソースのケースは解決しましたか?

はい。元の投稿者はクリーンアップが機能したことを確認しています。

ZimaOSのAppDataディレクトリ全体を削除すべきですか?

いいえ。重要なデータをバックアップしたうえで、確認済みのアプリ専用パスだけを削除してください。