初期パスワード変更(コミッショニング必須)
AI スタックをインストールした後、人がログインする画面のアカウントを整理する手順です。 サービス同士で使うキーのローテーションは パスワード・API キー変更 にあります。
管理コンソールアカウント
AI 管理コンソール は 環境変数でアカウントを決めます。 データベースにユーザーを置かないため、画面上でパスワードを変更する機能はありません。
| 環境変数 | 意味 | デフォルト値 |
|---|---|---|
PI_ADMIN_USER | ログイン ID | admin |
PI_ADMIN_PASSWORD | ログインパスワード | なし — インストール時に必ず指定 |
PI_ADMIN_SESSION_SECRET | セッション署名キー | インストーラーが作成します(ppss_ で始まるランダムな値) |
コンソールコンテナ(plantpulse-admin-api)は、この値を ADMIN_AUTH_USERNAME · ADMIN_AUTH_PASSWORD ·
ADMIN_SESSION_SECRET という名前で受け取ります。compose が渡すものなので、運用者が修正する
のは上表の PI_* という名前です。
テンプレートの PI_ADMIN_PASSWORD はプレースホルダー(CHANGE_ME_…)であり、インストーラーはこの値を作成しません
— 人がその値でログインするためです。プレースホルダーのままでは START=1 の起動が拒否され、空にすると
コンソールが起動を拒否します。つまり「デフォルト値をそのまま使っていた」ということが
起こり得ない構造です。
インストール時に決めた値がそのまま運用値になるため、その値が一時的に決めた弱い値ではないか、コミッショニング時に一度
点検してください。
変更方法
bin/passwd.sh が管理するキー一覧にコンソールアカウントは含まれていません。
環境ファイルを直接修正し、コンテナを作り直します。
sudo vi /etc/kopens/plantpulse-ai.env # PI_ADMIN_PASSWORD 수정
cd /opt/kopens/plantpulse-ai-docker/bin
./up.sh # 컨테이너 재생성
PI_ADMIN_SESSION_SECRET はインストール時に一度だけ作成されます。値を変更すると、それまでのログインが全て
解除されます。空にすると compose が起動を拒否します。
LiteLLM 管理画面アカウント
モデルゲートウェイ(LiteLLM)の管理画面 http://<AI 서버>:4000/ui に人が入るときに使う
アカウントです(ポートを PI_LITELLM_PORT に変更した場合はそのポート)。API 呼び出しには使われません(そちらはマスターキーや仮想キー)。
| 環境変数 | 意味 | デフォルト値 |
|---|---|---|
PI_LITELLM_UI_USERNAME | ログイン ID | admin(テンプレートではコメントアウトされています) |
PI_LITELLM_UI_PASSWORD | ログインパスワード | admin123! |
admin123! はテンプレートに記載された値であり、インストーラーが新規作成することはありません。4000 番は LAN に開いて
いるため、そのままにすると同じ網の誰でもゲートウェイ管理画面に入れます。
PI_LITELLM_UI_PASSWORD は必須です — 空または存在しない場合、compose が起動を拒否します。
LiteLLM はこの値がないと UI パスワードとしてマスターキー(PI_LLM_API_KEY)を使うため、人が
API 全体を開くキーを入力してしまうことを防ぐために分けて設けています。
変更方法はコンソールアカウントと同じです — passwd.sh 一覧にないため、環境ファイルを修正して ./up.sh で
作り直します。
このアカウントは 2026.09 で追加されました。インストーラーは既存の環境ファイルを再作成しないため、古い
ファイルにはこの行がありません。そのまま
アップグレードすると PI_LITELLM_UI_PASSWORD がないというエラーで起動が止まります。/etc/kopens/plantpulse-ai.env に
直接追加してください(値は新しく決めたパスワードで)。
PI_LITELLM_UI_PASSWORD=<password>
インフラアカウントと API キー
サービス同士で使う認証情報です。bin/passwd.sh が対象一覧を持っています。
cd /opt/kopens/plantpulse-ai-docker/bin
./passwd.sh --list # 무엇을 바꿀 수 있는지 (현재값은 마스킹)
./passwd.sh --list --show # 현재값 전체
./passwd.sh PI_INBOUND_API_KEY
./passwd.sh --generate PI_INBOUND_API_KEY # 값을 직접 만들지 않고 도구가 만들게
| キー | 内容 |
|---|---|
PI_NEO4J_PASSWORD | Neo4j — LightRAG ナレッジグラフと工場グラフミラー、2 つのインスタンスを同時に変更します |
PI_RAG_API_KEY | RAG API キー — copliot-web · lightrag · rag-api が共用します |
PI_VLLM_API_KEY | vLLM API キー — lightrag · insight-api が共用します |
PI_LLM_API_KEY | LiteLLM マスターキー |
PI_LITELLM_SALT_KEY | LiteLLM ソルトキー — 🔴 変更すると、既に登録済みの外部モデルのキーが復号できなくなります。ローテーションしないでください |
PI_INBOUND_API_KEY | バックエンドインバウンドキー — rag · insight · parser · vision · デジタルスレッドが受け取り(空だとこの5つが起動を拒否します)、コパイロット・管理コンソールが同じ値で呼び出します |
PI_COPILOT_SECRET_KEY · PI_DT_SECRET_KEY はインストーラーが初回インストール時に作成し、コミッショニング時に変更する値ではありません
— 変更すると、そのキーで封じた資格情報が復号できなくなります。やるべきことは2つです。
- 値が存在するか確認します。
PI_COPILOT_SECRET_KEYが空だとコパイロットが起動を拒否します。2026.09 以下で アップグレードしたホストにはこの行自体がありません → 環境変数設定 - env ファイルのバックアップに両方の値が含まれるようにします。
交換がどうしても必要な場合は _PREVIOUS の手順に従います → パスワード・API キー変更
空の場合、起動前判定でスタックがそもそも立ち上がらず、バックエンドサービスも各自起動を拒否します(2026.10 再リリースから —
それ以前のサービスは「キーがなければ通過」でした)。しかし CHANGE_ME_… プレースホルダーは空値ではなくこの検査を
通過してしまい、その値は全てのインストールで同一の文字列です。インストーラーがプレースホルダーを新しい値に置き換えるので、
インストール直後に bin/doctor.sh でプレースホルダーが残っていないか確認してください。ローテーションは passwd.sh が
ファイルを先に修正し、その後再起動するという順序で行います。手動で修正する場合も同じ順序を守ってください。
PI_RAG_API_KEY · PI_VLLM_API_KEY · PI_INBOUND_API_KEY は利用者が複数います。一か所だけ
修正すると残りが認証に失敗するため、passwd.sh に変更してスタック全体を再起動してください。
確認
# 콘솔이 떴는가 — HTTP 5959 · HTTPS 5960 (2026.09 까지는 9080)
curl -sf http://127.0.0.1:5959/health && echo OK
curl -sfk https://127.0.0.1:5960/health && echo OK
ブラウザで旧パスワードでのログインがブロックされるかを実際に確認してください。
このページが扱わないもの
| 対象 | どこに |
|---|---|
| バックエンドインバウンドキー・LLM キー・Neo4j など | パスワード・API キー変更 |
公開 API(/api/v1)機械認証キー CO_API_V1_KEY(2026.09 まで CH_API_V1_KEY) | 環境変数設定 |
| AI Chat Web ユーザーアカウント | プラットフォームユーザー体系に従います → プラットフォームユーザー管理 |
| Platform・Edge・Studio の初期アカウント | 各製品ドキュメントの同名ページ |
関連ドキュメント
- AI 管理コンソール — コンソールの使い方とセッションポリシー
- パスワード・API キー変更 — キーローテーション全般
- インストールおよび設定