困ったときは

• 困ったときは
  • 停止・再起動
  • .env と config.ini の編集後
• var/config.ini を編集する
• アプリを更新・ロールバックする
  • 手順
  • MFA（多要素認証）の設定について
  • 特定のバージョンへの更新・ロールバック
  • 起動後の確認
• USBで導入する（オフラインのサーバー）
  • 手順
  • オフライン環境での注意事項
  • Air Gap環境での注意事項

困ったときは

• sudo shiraitoctl doctor
  • 不足している項目や、対処に必要なコマンドを確認できます。

• DockerやGPUなどの前提環境に問題がある場合
  • 次のコマンドを実行し、環境のセットアップをやり直してください。
    sudo shiraitoctl setup-host --profile <名前> --yes

• sudo shiraitoctl logs
  • 起動後に発生したエラーを確認できます。特定のサービスのログを確認する場合は、sudo shiraitoctl logs backend のようにサービス名を指定してください。 

• build の実行時に command not found: docker と表示される場合 
  •   STEP 2 の手順を再実行してください。

• 起動するものの、HTTPSの証明書エラーが発生する場合
  • STEP 4 の SITE_HOST に設定したホスト名が、このサーバーを指しているか確認してください。 
  • また、ポート80および443にインターネットからアクセスできることを確認してください。

停止・再起動

# 停止
sudo shiraitoctl down

# 再起動
sudo shiraitoctl restart

.env と config.ini の編集後

.env を変更した場合

起動後に .env を変更しても、restart だけではコンテナ内の環境変数は更新されません。変更を反映するには、up を再実行してコンテナを再作成してください。

初期管理者のパスワードの写し（ var/secrets/initial_admin_password、STEP 4-3）も、up の実行時に更新されます。

# 公開運用（prod）の場合  
bashsudo shiraitoctl up

# 社内・閉域環境（lan）の場合  
sudo shiraitoctl --env lan up

var/config.ini のみを変更した場合

同じ環境を指定して、restart を実行してください。

# 公開運用（prod）の場合  
bashsudo shiraitoctl restart

# 社内・閉域環境（lan）の場合  
sudo shiraitoctl --env lan restart

メール送信の確認

管理画面の「認証設定」にあるメール送信テストで、メールが送信できることを確認してください。MFA（多要素認証）を強制している環境では、ログイン時にログインコードが届くことでも確認できます。

メールが届かない場合は、次のコマンドでエラーを確認してください。

sudo shiraitoctl logs backend

var/config.ini を編集する

/opt/JPC/shiraito/var/config.ini は、アプリの標準設定ファイル config.default.ini に追加・上書きする、顧客固有の設定を保存するファイルです。

設定項目の説明は、 /opt/JPC/shiraito/app/config.default.ini 内のコメントを参照してください。編集する前に、var/config.ini のバックアップを取ってください。

なお、app/config.default.ini はアプリの更新時に置き換わるため、直接編集しないでください。

アプリを更新・ロールバックする

更新前に .env と var/ のバックアップを取り、次の順に実行してください。

まず、STEP 1と同じコマンドでインストーラーを最新版に更新します。古いインストーラーの shiraitoctl では、配布が終了した取得先からアプリを取得しようとするため、最新版を取得できない場合があります。

USBを使用する場合は、新しいUSBに含まれる install.sh を実行（sudo ./install.sh）してください。

手順

# 1. インストーラーを更新
wget -O - -q https://dist-ai.justplayer.com/infinicloud-ai/install.sh | sudo bash

# 2. バックアップ
sudo shiraitoctl backup-files

# 3. 停止
sudo shiraitoctl down

# 4. アプリを取得
sudo shiraitoctl pull-app             # 既定チャネルの最新版

# 5. ビルド
sudo shiraitoctl build

# 6. 起動
sudo shiraitoctl up                   # lan の場合は --env lan を付ける

# 7. 起動状態とログを確認
sudo shiraitoctl status
sudo shiraitoctl logs

MFA（多要素認証）の設定について

shiraito-app 2.1.26 以降に更新しても、MFAの強制設定は変更されません。2.1.26 より前のバージョンではMFAが常に強制されており、var/config.ini に require_mfa の設定がない場合、更新後も強制されます。

MFAを強制せずに使用する場合は、「STEP 4-4」の手順に従って require_mfa を false に設定してください。

特定のバージョンへの更新・ロールバック

特定のバージョンに更新する場合や、問題が発生したバージョンからロールバックする場合は、次のようにバージョンを指定してアプリを取得します。

sudo shiraitoctl pull-app 2.1.20

パッケージを再インストールしても、/opt/JPC/shiraito/var/、.env、var/config.ini は上書きされません。

ただし、データベースのスキーマやデータの互換性は、アプリのリリースごとに確認してください。ロールバックする前には、必ずバックアップを取ってください。

起動後の確認

モデルの状態によっては、起動に10分以上かかる場合があります。起動後は、status と logs で状態やエラーを確認してください。

USBで導入する（オフラインのサーバー）

インターネットに接続されていないサーバーには、配布用USBを使用してインストールします。

USBをサーバーに接続したら、以下の手順を実行してください。

手順

# 1. インストーラーを実行（USBのマウント先で）  
cd /media/InfiniCloudAI/ && sudo ./install.sh

# 2. 初期化（STEP 3と同じプロファイルを指定）
sudo shiraitoctl init --profile vram-96gb

# 3. アプリをUSBから取得（--from に USB のパスを指定）
sudo shiraitoctl pull-app    --from /media/InfiniCloudAI

# 4. モデルをUSBから取得
sudo shiraitoctl pull-models --from /media/InfiniCloudAI/models \
 Qwen/Qwen3.6-27B-FP8 openai/gpt-oss-20b intfloat/multilingual-e5-base

# 5.  STEP 4 の手順に従って .env（公開 URLやSMTP）を設定

# 6.  以降は STEP 5（doctor）〜 STEP 9（up）と同じ

オフライン環境での注意事項

オフライン環境では、setup-hostによるDockerやNVIDIAのリポジトリからのオンライン取得は利用できません。

Dockerなどの前提ソフトウェアは、あらかじめ導入済みのマシンを用意するか、必要な .deb / .rpm パッケージを事前に持ち込み、手動でインストールしてください。

Air Gap環境での注意事項

Air Gap環境では、使用するプロファイルで必要となる生成LLMと埋め込みモデルを、すべてUSBに収録してください。

また、var/config.ini でリランカーや音声認識を有効にする場合は、設定に応じて追加モデルも配布用USBに収録してください。

追加モデルの例：

• リランカー：BAAI/bge-reranker-v2-m3
• 音声認識：mobiuslabsgmbh/faster-whisper-large-v3-turbo