Home Assistant OS Add-on Deployment

Home Assistant OS or HA Supervised users can install SkyView with one click as an Add-on. SkyView provides two add-ons: yunkan (generic CPU version) and yunkan-openvino (Intel iGPU accelerated version).

1. Scope

amd64 architecture only

The SkyView add-on currently publishes amd64 images only. Raspberry Pi (armv7/aarch64) / HA Green / HA Yellow and other ARM hosts are not supported. Only an Intel NUC / mini PC / x86 PC running HA OS can use it.

Add-on	Suitable hardware	Inference speed
yunkan	Any amd64 HA OS host	CPU only
yunkan-openvino	Intel CPU + iGPU (11th-gen+ Iris Xe / N100 / N305)	iGPU accelerated, recommended

Install only one

The two add-ons use identical ports (all of 23406/23880/24214/24215/23515), so they can't be enabled at the same time. Choose yunkan-openvino for Intel machines, yunkan otherwise.

2. Add the SkyView repository

Recommended: one-click redirect. Open this page on a device that can reach HA and click the badge below; my.home-assistant.io automatically finds your HA and prefills the repository URL — just confirm.

The first click asks for your HA address (e.g. http://homeassistant.local:8123) and remembers it afterward. If the redirect fails or you don't have the My Home Assistant integration installed, use the manual method below.

Manual method:

1
Open the Add-on Store
HA web → Settings → Add-ons → Add-on Store
2
Add a custom repository
Top-right three-dot menu → Repositories → paste the URL below → Add
3
Paste this URL
The full address below, copy and paste it directly:

text

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

After adding it, the page refreshes and a "Yunkan" section appears at the bottom of the Add-on Store with two cards, yunkan and yunkan-openvino.

3. Install and start

1
Pick a variant
Click yunkan-openvino on Intel machines, yunkan otherwise
2
Install
The "Install" button at the bottom right; wait for the download to finish (image ~700MB, a few minutes the first time)
3
Configure (optional)
"Configuration" tab: the defaults work; adjust here only for special needs (custom ports, time zone)
4
Start
"Info" tab → "Start" button
5
Enable Start on boot + Watchdog
Turn on both toggles below: "Start on boot" + "Watchdog"; ensures the add-on is brought back automatically if the HA host reboots or the add-on crashes
6
Open the web UI
A "SkyView" entry appears in the sidebar (or visit http://<HA host IP>:23406/) to enter the Setup wizard

4. Data persistence

Add-on data goes automatically to HA's /share/yunkan/ directory (recordings, database, models, and 115 cookies all live here). This directory:

Is included in HA OS backups — a full backup via Supervisor → Backups includes /share/, so SkyView data comes along
Is accessible over external SMB — HA's default Samba add-on maps /share/, so you can browse recording files from a PC/NAS
Survives upgrades — an add-on upgrade only swaps the image; persistent data in /share is kept

5. Upgrading

The YunKan add-on follows the standard HA add-on update flow: HA notifies you when a new version is available (bottom-right toast + Settings → Add-ons → this add-on → yellow banner on top); just click "Update". The YunKan web console detects the add-on environment automatically and shows matching upgrade guidance — no extra upgrade component needs to be installed.

6. FAQ

My HA runs on a Raspberry Pi — what do I do?

The RPi is ARM architecture, which the SkyView add-on doesn't currently support. Buying a used Intel mini PC (N100 / 11th-gen NUC, etc.) to run HA OS is a common solution. Or keep HA OS on the RPi and install SkyView separately on another x86 machine, linking the two via MQTT bridging.

iGPU acceleration not working (yunkan-openvino variant)

The add-on config already sets devices: [/dev/dri:/dev/dri:rwm], so passthrough should be automatic. Common failure causes: the host has no iGPU (check HA Supervisor → Host system → whether the CPU is Intel), or the HA OS kernel doesn't support the machine's iGPU. Falling back to the yunkan (CPU) variant still works.

Don't install over the top when switching variants

To switch from yunkan to yunkan-openvino (or vice versa): uninstall the old one first (data is kept in /share/yunkan/) → install the new one → on startup it reuses the old data in /share, no need to set up again. Enabling both at once causes a port conflict.