ワンライン インストール（推奨）
インターネットにつながるサーバーであれば、コマンド一行でインストールが始まります。インストールスクリプトは配布
サーバー product.kopens.io から取得します。
curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh | sudo bash
閉域網の場合はこの方式を使えません → 閉域網インストール。
始める前に
| 確認すること | 内容 |
|---|---|
| 権限 | root で実行する必要があります（sudo bash） |
| ネットワーク | product.kopens.io · docker.kopens.io への HTTPS アクセスが可能であること |
| ハードウェア | GPU を含む要件 → システム要件 |
何を取得するか — リポジトリセット
AI スタックの compose は 3つのリポジトリが並んで存在する必要 があり、それで起動します。
/opt/kopens/
├── plantpulse-ai-docker/ ← 설치 본체
├── plantpulse-ai-inference-server/
└── plantpulse-timeseries-insight-server/
ワンライン インストールは、この3つをまとめたバンドル（plantpulse-ai-bundle.tar.gz）を取得して一括展開します。
別途用意するものはありません。 スクリプトは展開後に3つすべてが揃っているか確認し、ひとつでも欠けていれば
その名前を表示して別経路に切り替えます — 中途半端な状態で起動しないようにするための仕組みです。
GIT_USER · GIT_TOKEN を渡すと、バンドルの代わりに dev.kopens.io から git clone します。
顧客先には弊社の GitLab アカウントがないため、デフォルトはバンドル です。
値を指定してインストールする
環境変数は bash の前 に置きます。curl の後に置くとパイプを越えて渡りません。
curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh \
| sudo START=1 PP_DATALAKE_ADMIN_URL=https://192.168.0.41:4950 PP_DATALAKE_ADMIN_API_KEY=<플랫폼의 키> bash
空の値をひとつずつ確認しながら進めたい場合は 対話形式 で実行してください。
curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh | sudo INTERACTIVE=1 bash
| 環境変数 | デフォルト値 | 用途 |
|---|---|---|
INTERACTIVE | 0 | 1 の場合、空の値をプロンプトで確認します |
START | — | 1 の場合、インストール後すぐに起動します |
DEST | /opt/kopens/plantpulse-ai-docker | インストール先 |
BRANCH | master | 取得するブランチ |
REPO_HOST | （社内 Git ホスト） | 配布物を取得できなかった場合にのみ使う代替経路。値はインストールスクリプトに含まれています |
REPO_PATH | plantpulse-ai/plantpulse-ai-docker.git | リポジトリパス |
GIT_USER · GIT_TOKEN | — | プライベートリポジトリの認証 |
インストールスクリプト（install.sh）にそのまま渡される値も同じ場所に置きます。よく使うものだけを抜粋しています —
全体と各ステップの内容は インストール概要 を参照してください。
| 環境変数 | デフォルト値 | 用途 |
|---|---|---|
PP_DATALAKE_ADMIN_URL · PP_DATALAKE_ADMIN_API_KEY | — | Platform 資格情報を取得するアドレス（https://<플랫폼 호스트>:4950）とキー。指定すると確認しません |
PP_PROXY_CERT_SAN | このホストのアドレス | TLS 証明書に含める 接続アドレス・名前（カンマ区切りで複数指定可）。パブリック IP・VIP・ドメインで接続する場合は必ず指定してください。env ファイルにすでに記載されている値は再インストールしても維持されます |
ENV_TEMPLATE | env.gb10.example | AWS g7e（amd64）は env.g7e.example。機種とアーキテクチャが一致しない場合は停止します |
HOST_TUNING | apply（他のコンテナが動作中の場合 plan） | ホスト全体の設定を skip · plan · apply のどれにするか |
ALLOW_DOCKER_RECONFIGURE | — | 1 の場合、既存の Docker の設定変更・再起動を許可します |
SKIP_GPU | — | 1 の場合、NVIDIA ドライバ・toolkit のインストールをスキップします |
SKIP_WAIT · WAIT_READY_MIN | — · 15 | START=1 後の応答待ちをスキップするか、上限（分）を変更します |
INTERACTIVE=1 の場合、まず TLS 証明書の SAN を確認し、続いて Platform 資格情報を取得するアドレスとキー
（PP_DATALAKE_ADMIN_URL · PP_DATALAKE_ADMIN_API_KEY）を確認します。それでも残っているプレースホルダー（Platform API トークン・
管理者パスワード・Neo4j パスワードなど）はひとつずつさらに確認します。Platform ホストと Platform PG・Aster TSDB・Redis アカウント・
パスワードは 2026.10 以降確認されません — ホストは上記アドレスから算出され、アカウント・パスワードは起動時に Platform から取得します。内部シークレット（ゲートウェイキー・ソルト・インバウンドキー・セッションシークレット・
保存資格情報暗号化キーなど）は 確認せずインストーラーが生成します。
確認される値は、対話形式の代わりに 同名の環境変数 で渡すこともできます（… | sudo PP_API_TOKEN=<token> PI_ADMIN_PASSWORD=<password> bash）。
インストーラーは まだプレースホルダーのままのキーだけ をその値で埋め、すでに設定済みの値は上書きしません。
Platform トラストアンカー /etc/kopens/ca/root.crt（同じ内容を CA.crt としても）はインストーラーが作成しません。START=1 の場合、
インストーラーはイメージを取得する前に Platform から資格情報を一度取得しようとし、アンカーがないかキーが間違っている場合は 何も起動せずに
停止します。先にアンカーを設置して START=1 で実行し直すか、START を使わず 準備のみ を行ってからアンカーを設置して起動してください →
インストール概要
インストールが終わったら
- 初期パスワード変更 — 管理コンソールアカウントを設定します。
PI_ADMIN_PASSWORDがプレースホルダーのまま残っているとSTART=1の起動が拒否され、空の場合は コンソール自体が起動しません。 - AI 管理コンソール にアクセスし、ホームで全体の状態を確認します。
- サービスポートマップ でファイアウォールを整理します。
- 映像・音声収集とチャットでの音声質問を使う場合は、ホスト env に
PI_MEDIA_ENABLED=trueを一行追加して音声認識モデルを 取得します — デフォルトはオフです → 映像・音声収集