動作要件

セルフホスティングの Nodaro の動作要件は 5 つです。Docker、ログイン機能を備えたデータベース、S3 互換のオブジェクトストレージ、Redis、そして 1 つ以上のモデルプロバイダーです。Community エディション用の Compose スタックにはデータベース、ストレージ、Redis が同梱されているため、1 台のサーバーで動かすなら、必要なのは Docker とモデルプロバイダーだけです。このページのそれ以外の項目は、任意か、本番環境向けのものです。

必要なもの

Nodaro はブラウザーに公開のメディア URL を渡すため、メディアはユーザーのブラウザーからログインなしで読み取れる必要があります。同梱の MinIO は、アプリ自身のアドレスの /storage/ 以下でこれを実現しています。自分のバケットを使う場合は、オブジェクトストレージを設定するを参照してください。

モデルプロバイダー

AI モデルを呼び出すノードには、プロバイダーが必要です。プロバイダーがなくても環境は起動し、デモも開けますが、モデルを使うノードはどれも実行できません。/setup ページか .env で、次のキーを 1 つ以上追加してください。

キーの代わりに、環境を Nodaro Cloud アカウントに接続することもできます。Nodaro Cloud への接続を参照してください。特定のノードで使うキーも含めた全一覧は、プロバイダーキーにあります。

任意で用意するもの

• Node.js 22 以降：開発のために、API やワーカーを Docker の外で動かす場合に必要です。tools/ にあるコマンドラインのプローブとキー生成ツールも、Node.js で動きます。
• ドメイン名と TLS 証明書：本番環境で必要です。リバースプロキシと HTTPS を参照してください。

ポート

Redis とデータベースは Compose のネットワーク内部で動き、ホストマシンのポートは使いません。3000 や 9001 がすでに使われている場合は、docker-compose.community.yml で、そのポートマッピングのホスト側を変更してください。

ディスク

• イメージ：初回起動時に、約 2.4 GB をダウンロードします。
• ボリューム：db-data にはデータベース、minio-data にはメディア、redis-data にはキュー、app-data にはインスタンスの暗号化キーが保存されます。Nodaro は保存したメディアを自動では削除しないため、メディアのボリュームは結果が増えるたびに大きくなります。古いメディアを一定期間後に削除したい場合は、バケットにライフサイクルルールを追加してください。スケーリングを参照してください。

マシンのサイズ

デフォルトの構成では、すべてを 1 つのコンテナで動かします。アクティブユーザーが 5 人程度までなら、この構成で問題ありません。最も重い処理はレンダリングです。レンダリングワーカーはヘッドレス Chrome を動かし、CPU がボトルネックになるため、レンダリングワーカーは 1 台のマシンにつき 1〜2 個を目安にしてください。ユーザーがそれより多い場合は、ワーカーを複数のコンテナに分けます。スケーリングを参照してください。

アプリのイメージには、amd64 と arm64 のマシン向けのビルドがあります。

Windows

Windows では、バックアップと復元のスクリプトを、PowerShell や WSL ではなく Git Bash（Git for Windows と一緒にインストールされるシェル）から実行してください。バックアップと復元を参照してください。