# Déploiement sur Unraid

Les utilisateurs d'Unraid devraient **privilégier l'installation en un clic via Community Applications** (recherchez simplement « yunkan » dans Apps — l'expérience est équivalente à celle de l'add-on HA) ; utilisez la voie docker compose ci-dessous si vous avez besoin de ports personnalisés ou si votre version d'Unraid est ancienne. Les deux voies couvrent l'iGPU Intel et le GPU NVIDIA.

## Voie recommandée : installation en un clic (Community Applications)

Community Applications d'Unraid (appelé **CA** en abrégé, l'onglet Apps) est un magasin d'applications maintenu par la communauté. SkyView y est référencé officiellement, si bien que **les utilisateurs d'Unraid peuvent simplement rechercher « yunkan » dans Apps et l'installer en un clic** — aucun dépôt de modèle à ajouter, une expérience équivalente à celle de l'add-on Home Assistant. Pas de compose à écrire à la main, pas de SSH.

> **💡 Quand utiliser CA plutôt que compose**
>
> **La plupart des utilisateurs Unraid peuvent se contenter de CA** : YunKan regroupe tous les processus dans un seul conteneur, une installation via CA fonctionne immédiatement — la mise à niveau en ligne en un clic depuis la console web fonctionne aussi d'emblée (le modèle monte déjà le socket docker). **N'utilisez le chemin docker compose ci-dessous** que dans deux cas : (1) besoin de ports personnalisés (codés en dur dans l'image, non modifiables dans le panneau du conteneur) ; (2) Unraid < 6.12 / plugin CA absent.

1. **Vérifier que le plugin Community Applications est installé**

   Unraid 6.10+ l'inclut généralement par défaut. Si l'onglet Apps est visible, c'est bon. S'il manque, allez dans Plugins → Install Plugin et collez `https://raw.githubusercontent.com/Squidly271/community.applications/master/plugins/community.applications.plg` pour l'installer.

2. **Rechercher et installer (choisissez-en une seule ; **les conflits de ports empêchent d'en installer plusieurs**)**

   Onglet Apps → tapez `yunkan` dans la recherche → 3 variantes apparaissent : **YunKan** (CPU uniquement, aucune dépendance matérielle) / **YunKan-OpenVINO** (iGPU Intel, installez d'abord le plugin Intel GPU TOP) / **YunKan-CUDA** (GPU NVIDIA, installez d'abord le plugin NVIDIA Driver). Cliquez sur **Install** sur la variante correspondante ; les valeurs par défaut conviennent, avec un répertoire de données par défaut à `/mnt/user/appdata/yunkan/data`.

3. **Premier démarrage → assistant de configuration**

   Une fois le conteneur démarré, trouvez le conteneur yunkan dans l'onglet Docker → cliquez sur **WebUI** (ou ouvrez directement `http://<Unraid IP>:23406/`) → accédez à l'[assistant de configuration](/docs/quickstart) → choisissez SQLite → créez un administrateur → ajoutez une caméra.

> **ℹ️ Dépendances des plugins GPU, ports et FAQ**
>
> La variante OpenVINO nécessite d'abord le plugin **Intel GPU TOP**, et la variante CUDA nécessite d'abord le plugin **NVIDIA Driver** — les étapes détaillées figurent ci-dessous dans [2. Prérequis](#2-prerequisites). Les avertissements sur les **conflits de ports / l'exposition publique / le passthrough iGPU** des sections consacrées à compose ci-dessous s'appliquent aussi à la voie CA.

> **ℹ️ Mises à jour OTA**
>
> Sur le chemin CA, l'onglet Apps affiche un badge rouge quand une nouvelle version est disponible : cliquez sur **Update** pour télécharger la nouvelle image et recréer le conteneur. Vous pouvez aussi mettre à niveau en un clic depuis la console web YunKan → Paramètres → Mise à niveau du système (retour arrière automatique en cas d'échec). Les deux méthodes sont équivalentes.

## Ou : la voie docker compose (personnalisation / Unraid ancien)

Voici la voie de déploiement traditionnelle avec un compose écrit à la main, **pour les utilisateurs ayant besoin de ports personnalisés ou utilisant Unraid < 6.12 sans le plugin CA**. Si vous avez utilisé l'installation en un clic via CA ci-dessus, vous pouvez ignorer cette section et passer directement à l'installation du plugin GPU dans [2. Prérequis](#2-prerequisites), ou aller directement à [5. Ports et pare-feu](#5-ports-and-firewall) / [6. FAQ](#6-faq).

## 1. Matériel pris en charge et variante recommandée

| Matériel | Variante recommandée | Plugin requis |
| --- | --- | --- |
| CPU Intel + iGPU (11e génération et plus) | openvino | Intel GPU TOP |
| GPU NVIDIA (GTX 1060+ / VRAM ≥ 4 Go) | cuda | NVIDIA Driver |
| GPU NVIDIA + VRAM ≥ 8 Go (2060+ / 3060+) | trt | NVIDIA Driver |
| CPU uniquement (pas d'iGPU / pas de GPU dédié) | cpu | Aucun |

## 2. Prérequis

1. **Vérifier la version d'Unraid**

   Tools → Update OS, vérifiez que la version est ≥ 6.12.13 (les versions plus anciennes nécessitent le plugin Docker Compose Manager)

2. **Installer le plugin GPU**

   Dans l'onglet Apps, recherchez le plugin correspondant : installez **Intel GPU TOP** pour un iGPU Intel, **NVIDIA Driver** pour NVIDIA ; un redémarrage sera demandé après l'installation, après quoi `/dev/dri` ou `/dev/nvidia*` apparaît

3. **Créer le répertoire AppData**

   Unraid utilise par convention `/mnt/user/appdata/yunkan/` ; créez-le puis placez-vous dedans pour y déposer le fichier compose

## 3. Récupérer le fichier compose

Choisissez l'une des trois méthodes : téléchargement depuis le navigateur, wget via SSH, ou coller la version minimale dans le Compose Manager d'Unraid :

[Télécharger compose.yml](/compose/unraid.yml)

Unraid 6.12+ · variante openvino · mise à jour en ligne via la console web

Ou connectez-vous en SSH à Unraid (ou utilisez le plugin Terminal) :

```bash
ssh root@<Unraid IP>
mkdir -p /mnt/user/appdata/yunkan
cd /mnt/user/appdata/yunkan
wget https://yun-kan.com/compose/unraid.yml -O compose.yml
```

> **💡 iGPU Intel ou GPU NVIDIA**
>
> Le fichier compose par défaut utilise la variante openvino (iGPU Intel). Pour NVIDIA : changez `image:` en `yunkan-cuda` ou `yunkan-trt`, et décommentez `deploy.resources` dans le fichier.

```yaml
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/user/appdata/yunkan/data:/app/data
      - /mnt/user/appdata/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
```

*compose.yml (minimal, à coller et enregistrer)*

## 4. Démarrer SkyView

**Option A · CLI** (recommandée, fonctionnalités complètes) :

```bash
cd /mnt/user/appdata/yunkan
docker compose up -d
docker logs -f yunkan
```

**Option B · Interface graphique** : interface web d'Unraid → onglet Docker → bloc « Compose Manager » → « Add New Stack » → nommez-le yunkan → collez le contenu de compose.yml → « Compose Up ».

Une fois démarré, ouvrez `http://<Unraid IP>:23406/` dans le navigateur pour accéder à l'[assistant de configuration](/docs/quickstart).

## 5. Ports et pare-feu

Unraid n'a pas de pare-feu par défaut, tous les ports sont donc exposés directement sur l'interface réseau de l'hôte ; SkyView utilise 23406/23880/24214/24215/tcp + 23515/udp.

> **⚠️ Ne pas exposer sur Internet**
>
> Unraid écoute sur 0.0.0.0 par défaut, sans pare-feu = n'importe quel appareil en amont sur Internet peut scanner directement vos caméras. **Passez toujours par Tailscale / Wireguard / Cloudflare Tunnel + HTTPS**. Voir [Clients → Accès distant](/docs/clients#remote-access-essentials).

## 6. FAQ

> **ℹ️ Le passthrough iGPU ne fonctionne pas / OpenVINO signale GPU introuvable**
>
> Vérifiez que le plugin Intel GPU TOP est installé et que vous avez redémarré, puis exécutez `ls -la /dev/dri/` en SSH — vous devriez voir card0 / renderD128. Sinon, soit le mauvais plugin est installé, soit la machine n'a pas d'iGPU (vérifiez avec `lspci | grep -i vga`).

> **ℹ️ Le passthrough GPU NVIDIA ne fonctionne pas**
>
> Exécutez `nvidia-smi` en SSH (disponible une fois le plugin NVIDIA Driver installé) ; si le GPU s'affiche, le côté hôte est correct. Si `docker exec yunkan nvidia-smi` échoue dans le conteneur après le démarrage de compose, vérifiez que l'image est bien yunkan-cuda et non yunkan-openvino.

**Mise à jour :** les permissions du socket docker sont normales sur Unraid, la mise à jour en ligne en un clic depuis la console web fonctionne donc directement ; vous pouvez aussi mettre à jour manuellement avec `cd /mnt/user/appdata/yunkan && docker compose pull && docker compose up -d`.

---

来源:https://yun-kan.com/fr/docs/install-unraid