TrueNAS Scale デプロイ

1. 対応ハードウェアと推奨バリアント

2. 事前準備

1. 1

   TrueNAS を 24.10+ にアップグレード

   System Settings → Update → 24.10-Electric-Eel train を選択し、移行が完了するのを待ちます

2. 2

   ZFS データセットを作成

   Datasets → プールを選択 → yunkan-data データセットを新規作成します。パスは /mnt/pool0/apps/yunkan/data のような形になります。後で compose がここを /app/data にマウントします

3. 3

   GPU を確認

   Apps → Settings → GPU で、ホスト上で検出された iGPU / NVIDIA を確認し、使用するバリアントを決めます

3. compose ファイルを取得

TrueNAS では UI 経由の Custom App YAML でのデプロイが推奨されていますが、SSH で直接 docker compose を実行することもできます。以下の 3 通りのいずれかで取得してください：

または SSH で wget（データセットのパスを変更するのを忘れずに）：

ssh root@<TrueNAS IP>
cd /mnt/pool0/apps/yunkan
wget https://yun-kan.com/compose/truenas.yml -O compose.yml
# ★ ファイル内の /mnt/pool0/apps/yunkan/data を実際のデータセットのパスに変更してください ★

name: yunkan

services:
  yunkan:
    image: registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-openvino:latest
    container_name: yunkan
    restart: always
    network_mode: host
    devices:
      - /dev/dri:/dev/dri
    volumes:
      - /mnt/pool0/apps/yunkan/data:/app/data
      - /mnt/pool0/apps/yunkan/recordings:/app/data/recordings
      - /etc/machine-id:/etc/machine-id:ro
      - /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
      - SKYVIEW_SELF_CONTAINER_NAME=yunkan

4. SkyView を起動

方法 A · Custom App：Apps UI で Save → Install をクリックし、ステータスが Running になるのを待ちます。

方法 B · SSH：

cd /mnt/pool0/apps/yunkan
docker compose up -d
docker logs -f yunkan

起動後、ブラウザで http://<TrueNAS IP>:23406/（TrueNAS UI は 80/443 のため競合しません）を開き、セットアップウィザード へ進んでください。

5. ポートとファイアウォール

TrueNAS Scale の Web UI は 80/443 を使用しており、SkyView の 23406 系ポートとは競合しません。Scale はデフォルトで追加のファイアウォールを持たず、SCALE-Apps は host network で直接ポートをバインドします。

6. よくある質問

アップグレード：Apps UI からのアップグレード（Edit → image タグを変更 → Save）を推奨します。または SSH で docker compose pull && docker compose up -d。