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

ZimaOSでNextcloudにMariaDBまたはPostgreSQLを使用する方法

A ZimaOS 1.3.3 user asked for step-by-step guidance to make MariaDB or PostgreSQL work with Nextcloud. The thread received no technical solution, so current ZimaOS packaging behavior is important context.

Nextcloudのデータベース問題とは何だったのか?

2025年4月、ZimaOS 1.3.3のユーザーから、NextcloudでMariaDBもPostgreSQLも期待どおりに動作しないようだという報告があり、手順に沿った設定方法が求められました。2026年1月には別のユーザーが同じ質問を繰り返しましたが、コミュニティのスレッドには技術的な回答が寄せられませんでした。

つまり、元の議論からは、別途インストールしたデータベースコンテナをZimaOSのNextcloudパッケージに接続するための、動作するデータベースホスト名、ユーザー名、パスワード、ネットワーク、ポート、ボリューム設定は確立されていません。

現在のZimaOSでMariaDBとPostgreSQLは利用できますか?

はい。現在のZimaOS App Storeには、インストール可能なデータベースアプリケーションとしてMariaDBとPostgreSQLが掲載されています。ZimaOSにはNextcloudパッケージも用意されています。ただし、これらのアプリを別々にインストールしただけでは、一方のコンテナが別のアプリケーションの共有依存関係として自動的に接続されるわけではありません。

現在のアプリケーションモデルについては、ZimaOS App Storeガイドをご覧ください。

なぜ別のデータベースはNextcloudに自動接続されないのですか?

現在のZimaOS開発者向けドキュメントでは、現段階で、共有サービスや事前インストール済みまたは推奨される依存関係をApp Storeの依存関係モデルとして自動的に扱う機能はサポートされていないと明記されています。アプリは通常、自己完結型のDockerデプロイメントとしてパッケージ化されるか、必要なサービスがアプリケーション独自のcompose定義に含まれています。

これが元の質問の背景にある重要な制限です。MariaDBまたはPostgreSQLのアプリがZimaOS上で正常に動作していても、Nextcloudのデプロイメントとは完全に分離されたままになる可能性があります。

外部データベースを動作させるには、何を一致させる必要がありますか?

設定 重要な理由
データベースエンジン Nextcloudのデプロイメントが、選択したデータベースエンジンをサポートしている必要があります。
データベースホスト Nextcloudから実際にデータベースサービスへ到達できるホスト名またはコンテナネットワークアドレスが必要です。
ポート 関連するネットワーク内で、データベースが想定されるMariaDB/MySQLまたはPostgreSQLのポートをリッスンしている必要があります。
データベース名 Nextcloudインスタンス用のデータベースが存在するか、作成されている必要があります。
ユーザーとパスワード Nextcloudに入力する認証情報が、データベースのアカウントおよび権限と一致している必要があります。
Dockerネットワーク 別々にインストールした2つのコンテナ間でコンテナホスト名を解決するには、まず到達可能なネットワーク経路を共有している必要があります。
永続ストレージ 更新やコンテナの再作成後もデータベースファイルが保持されるよう、永続ストレージに保存する必要があります。

より安全なZimaOSのデプロイ方法は?

動作するNextcloudインスタンスだけが必要な場合は、関係のないデータベースコンテナを先にインストールするのではなく、現在提供されているパッケージ版のNextcloudから始めてください。外部のMariaDBまたはPostgreSQLサーバーがどうしても必要な場合は、Nextcloudとデータベースを1つの計画的なスタックとして扱い、すべての環境変数、ネットワーク、認証情報、永続パスをまとめて確認してください。

ZimaOSは、ワンクリックパッケージよりも細かくDockerデプロイメントを管理したいユーザー向けに、カスタムアプリケーションのインストールをサポートしています。データベースに依存するサービスでは、依存関係が定義されていない2つのApp Storeエントリを独立してインストールするよりも、上流の完全なデプロイメントまたはAIOデプロイメントのほうが、一般的に構成を把握しやすくなります。

よくある質問

現在のZimaOSではMariaDBとPostgreSQLを提供していますか?

はい。どちらも現在のZimaOSエコシステムでデータベースアプリケーションとして利用できます。

MariaDBをインストールすれば、Nextcloudは自動的にそれを使用しますか?

いいえ。App Storeから別々にインストールしても、データベースの依存関係が自動的に作成されたり、Nextcloudがそのデータベースを使用するよう設定されたりすることはありません。

元のコミュニティスレッドには、検証済みの手順どおりの解決策が記載されていましたか?

いいえ。スレッドには質問と、同じ要件を持つ後のユーザーからの投稿がありましたが、確認済みの設定方法は投稿されていません。

現在のコンテナネットワークと永続パスが分からない状態で、データベースやNextcloudの設定を編集すべきですか?

いいえ。まず現在のアプリケーション構成を確認してください。そうしないと、変更によってデータベースへの接続が切断されたり、重要なデータが永続化されないストレージに置かれたりする可能性があります。