# Déploiement en add-on sur Home Assistant OS

Les utilisateurs de Home Assistant OS ou HA Supervised peuvent installer SkyView en un clic sous forme d'add-on. SkyView propose deux add-ons : `yunkan` (version CPU générique) et `yunkan-openvino` (version accélérée par iGPU Intel).

## 1. Portée

> **⚠️ Architecture amd64 uniquement**
>
> L'add-on SkyView ne publie actuellement que des images amd64. **Raspberry Pi (armv7/aarch64) / HA Green / HA Yellow et autres hôtes ARM ne sont pas pris en charge**. Seul un NUC Intel / mini PC / PC x86 exécutant HA OS peut l'utiliser.

| Add-on | Matériel adapté | Vitesse d'inférence |
| --- | --- | --- |
| **yunkan** | Tout hôte HA OS amd64 | CPU uniquement |
| **yunkan-openvino** | CPU Intel + iGPU (11e génération et plus Iris Xe / N100 / N305) | Accéléré par iGPU, recommandé |

> **ℹ️ N'en installer qu'un seul**
>
> Les deux add-ons utilisent des ports identiques (23406/23880/24214/24215/23515), ils **ne peuvent donc pas être activés en même temps**. Choisissez yunkan-openvino pour les machines Intel, yunkan sinon.

## 2. Ajouter le dépôt SkyView

**Recommandé : redirection en un clic.** Ouvrez cette page sur un appareil pouvant atteindre HA et cliquez sur le badge ci-dessous ; `my.home-assistant.io` retrouve automatiquement votre HA et préremplit l'URL du dépôt — il ne reste qu'à confirmer.

[![Ajouter à Home Assistant](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fmrtian2016%2Fyunkan-hassio-addons)

Le premier clic demande l'adresse de votre HA (par ex. `http://homeassistant.local:8123`) et s'en souvient ensuite. Si la redirection échoue ou que vous n'avez pas l'intégration My Home Assistant installée, utilisez la méthode manuelle ci-dessous.

**Méthode manuelle :**

1. **Ouvrir le magasin d'add-ons**

   Interface web HA → Paramètres → Add-ons → Magasin d'add-ons

2. **Ajouter un dépôt personnalisé**

   Menu à trois points en haut à droite → Dépôts → collez l'URL ci-dessous → Ajouter

3. **Coller cette URL**

   L'adresse complète ci-dessous, à copier-coller directement :

```text
https://github.com/mrtian2016/yunkan-hassio-addons
```

Une fois ajouté, la page se rafraîchit et une section « Yunkan » apparaît en bas du magasin d'add-ons avec deux cartes, `yunkan` et `yunkan-openvino`.

## 3. Installer et démarrer

1. **Choisir une variante**

   Cliquez sur `yunkan-openvino` sur les machines Intel, `yunkan` sinon

2. **Installer**

   Le bouton « Install » en bas à droite ; attendez la fin du téléchargement (image d'environ 700 Mo, quelques minutes la première fois)

3. **Configurer (facultatif)**

   Onglet « Configuration » : les valeurs par défaut conviennent ; n'ajustez ici que pour des besoins particuliers (ports personnalisés, fuseau horaire)

4. **Démarrer**

   Onglet « Info » → bouton « Start »

5. **Activer le démarrage automatique + Watchdog**

   Activez les deux options ci-dessous : « Start on boot » + « Watchdog » ; garantit que l'add-on redémarre automatiquement si l'hôte HA redémarre ou si l'add-on plante

6. **Ouvrir l'interface web**

   Une entrée « SkyView » apparaît dans la barre latérale (ou visitez `http://<IP hôte HA>:23406/`) pour accéder à l'[assistant de configuration](/docs/quickstart)

## 4. Persistance des données

Les données de l'add-on vont automatiquement dans le répertoire `/share/yunkan/` de HA (enregistrements, base de données, modèles et cookies 115, tout y est). Ce répertoire :

- **Est inclus dans les sauvegardes HA OS** — une sauvegarde complète via Supervisor → Backups inclut `/share/`, donc les données SkyView sont incluses
- **Est accessible via SMB externe** — l'add-on Samba par défaut de HA mappe `/share/`, vous pouvez donc parcourir les fichiers d'enregistrement depuis un PC/NAS
- **Survit aux mises à jour** — une mise à jour de l'add-on ne fait que remplacer l'image ; les données persistantes dans /share sont conservées

## 5. Mise à jour

Le module complémentaire YunKan suit le flux de mise à jour standard des add-ons HA : HA vous notifie quand une nouvelle version est disponible (toast en bas à droite + Paramètres → Modules complémentaires → ce module → bandeau jaune en haut) ; cliquez simplement sur « Mettre à jour ». La console web YunKan détecte automatiquement l'environnement add-on et affiche les instructions adaptées — aucun composant de mise à niveau supplémentaire n'est requis.

## 6. FAQ

> **ℹ️ Mon HA tourne sur un Raspberry Pi — que faire ?**
>
> Le RPi est en architecture ARM, que l'add-on SkyView ne prend pas encore en charge. Acheter un mini PC Intel d'occasion (N100 / NUC 11e génération, etc.) pour exécuter HA OS est une solution courante. Ou gardez HA OS sur le RPi et installez SkyView séparément sur une autre machine x86, en reliant les deux via [le pont MQTT](/docs/automation#home-assistant).

> **ℹ️ L'accélération iGPU ne fonctionne pas (variante yunkan-openvino)**
>
> La configuration de l'add-on définit déjà `devices: [/dev/dri:/dev/dri:rwm]`, le passthrough devrait donc être automatique. Causes d'échec courantes : l'hôte n'a pas d'iGPU (vérifiez HA Supervisor → Host system → si le CPU est Intel), ou le noyau HA OS ne prend pas en charge l'iGPU de la machine. Revenir à la variante yunkan (CPU) fonctionne toujours.

> **⚠️ Ne pas installer par-dessus lors d'un changement de variante**
>
> Pour passer de yunkan à yunkan-openvino (ou l'inverse) : désinstallez d'abord l'ancien (les données sont conservées dans /share/yunkan/) → installez le nouveau → au démarrage il réutilise les anciennes données dans /share, aucune reconfiguration nécessaire. Activer les deux en même temps provoque un conflit de ports.

---

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