システム要件
ハードウェア要件
最小構成
| 項目 | 仕様 |
|---|---|
| CPU | 8コア以上 |
| RAM | 32GB以上 |
| ストレージ | SSD 500GB以上 |
| GPU | NVIDIA GPU（CUDA対応） |
| ネットワーク | 1Gbps以上 |
推奨構成
| 項目 | 仕様 |
|---|---|
| CPU | 16コア以上 |
| RAM | 64GB以上 |
| ストレージ | NVMe SSD 1TB以上 |
| GPU | NVIDIA DGX Spark または同等品 |
| ネットワーク | 10Gbps |
PlantPulse AIは、NVIDIA DGX Sparkなど低スペックGPU環境でも運用できるよう最適化されています。
ソフトウェア要件
| 項目 | 内容 |
|---|---|
| OS | Ubuntu 22.04 · RHEL / Rocky / Alma 8·9 · Amazon Linux 2 |
| コンテナ | Docker CE + compose v2 プラグイン — インストーラが入れます。 すでにある場合はそのまま使います |
| GPU ドライバ | NVIDIA ドライバ + container toolkit — インストーラが入れます（SKIP_GPU=1 でスキップ）。ドライバを新規に入れる場合は再起動が必要になることがあります |
すべてのサービスがコンテナとして動作します。ホストに必要なのは上記の3つだけです。
NVIDIAデバイスがない場合、インストーラはドライバ手順をスキップし、runtime: nvidia を使うサービス（vLLM
生成・埋め込み・再順位付け）は起動しないと警告します。
GPUメモリの割当
vLLMセットと文字起こし用vLLM、時系列推論サーバーが同じGPUを分け合って使います。 各自が取得する割当
（LLM_GPU_UTIL · EMB_GPU_UTIL · RERANK_GPU_UTIL · TS_GPU_UTIL · ASR_GPU_UTIL）の合計が上限
PP_GPU_BUDGET_CEILING を超えると起動前に停止します。 割当と上限はホストenvではなく
ハードウェアプロファイル（compose/profiles/<모양>.env）に定義されており、ホストenvの PP_HW_PROFILE がそれを選択します。
文字起こし（ASR_GPU_UTIL）はデフォルトでオフですが、オンにする日に超過しないよう合計にあらかじめ含めています — 映像・音声をオンにしても（PI_MEDIA_ENABLED=true）
GPU割当を再計算する必要はありません。オンにすると文字起こしモデル Aura-ASR-Turbo がディスクを約1.6GB追加で使用します → 映像・音声収集
| ハードウェア | テンプレート・PP_HW_PROFILE | 割当の合計 (LLM + EMB + RERANK + TS + ASR) | 上限 |
|---|---|---|---|
| GB10系列 (arm64、統合メモリ) | env.gb10.example · gb10 | 0.4 + 0.10 + 0.08 + 0.13 + 0.03 = 0.74 | 0.75 |
| AWS g7e (amd64、専用VRAM) | env.g7e.example · g7e | 0.53 + 0.13 + 0.10 + 0.15 + 0.04 = 0.95 | 0.95 |
GB10はGPUメモリがシステムRAMと同じプールであるため、モデルがすべてを取得するとOSや他のサービスが使える分が なくなります。詳細は環境変数設定にあります。
ネットワーク要件
PlantPulse AIは以下のポートを使用します。ファイアウォールポリシーで該当ポートを許可する必要があります。
外部アクセスが必要なポート
| ポート | サービス | 説明 |
|---|---|---|
| 80 / 443 | AI Chat Web | Webチャットインターフェース（唯一の外部公開） |
ホストに併せて開くポート
プロキシを経由せずLANにそのまま開きます。社内網の外から届かないようファイアウォールで 遮断してください。
| ポート | サービス |
|---|---|
| 4000 | LiteLLM — モデルゲートウェイ（PI_LITELLM_PORT で変更） |
| 7115 | RAG関門 |
| 8970 | 時系列インサイト |
| 5959 | 管理コンソールHTTP（PI_ADMIN_WEB_PORT で変更） |
| 5960 | 管理コンソールHTTPS — プロキシ経由（PI_ADMIN_WEB_TLS_PORT で変更） |
| 7474 / 7687 | Neo4jブラウザ・Bolt |
インストーラはファイアウォールを開く際、composeが実際に発行するポートを読み取るため、上記変数で変更した値がそのまま 開きます。
2026.09までの 9080 は閉じられました。ブックマークとファイアウォールルールを 5959（HTTP）・5960（HTTPS）に移してください。
🔴 以前はLightRAGを 7114 で直接開いていましたが、現在は**rag-api（7115）が唯一の関門**
であり、LightRAG自体はコンテナ内にのみ存在します。ファイアウォールに 7114 を開く必要はありません。
ドキュメント理解(7120)・ビジョン(7130)・vLLM(8000)・埋め込み(8003)・リランカー(8004)・文字起こし（映像・音声をオンにしたインストール）・docling(5001)・ Qdrant(6333)・時系列推論(8980)・admin-api(9081)・デジタルスレッド(7140) とその専用Neo4jはホストポートを発行しません （2026-08-21）。Phoenix(6006)も2026.09から発行されません — 認証のないトレースUIである ためです。コンテナ同士でのみ呼び出すため、ファイアウォールの対象ではありません。
PostgreSQL(5432)・Aster TSDB(9042)・Redis(6379)・RustFS(9000/9001)はプラットフォームのものを借りて 使います — AIサーバーではなくプラットフォームサーバーで開いている必要があります。
AIコンテナは起動時にプラットフォームデータレイク管理API（https://<플랫폼 호스트>:4950）からアカウント・パスワードを
取得します。AIホストからそのポートへ出られる必要があり、AIホストIPがプラットフォーム許可リストに含まれている必要があります →
インストール概要
ポート全体のマップと確認コマンドはサービスポートマップにあります。
MCP・オントロジーツールはPlantPulseプラットフォームのserver-web統合MCP（/api/v5/mcp）で提供されます（旧MCP Server 50000・Ontology 8888独立サービスはアーカイブ済みです）。
PlantPulse IIoTサーバー連携
PlantPulse AIはPlantPulse IIoTプラットフォームのリアルタイムデータにアクセスします。以下の接続が必要です：
| 項目 | 説明 |
|---|---|
| PlantPulseサーバー | IIoTプラットフォームAPIサーバー（HTTPS） |
| Aster TSDBクラスタ | 時系列データストレージ |
| PostgreSQL | PlantPulseメタデータDB |
統合MCPはPlantPulse IIoTサーバーに対して読み取り専用アクセスのみを行います。書き込み操作はサポートしていません。