Synology DSM Deployment

Synology Intel + iGPU models (DS920+ / DS423+ / DS1522+ / DS224+, etc.) work best with the openvino variant. This page walks you step by step from SSH install to the browser Setup wizard. AMD/ARM models (DS223j / DS723+) have no /dev/dri and can only run the cpu variant — inference drops a tier but features are unchanged.

1. Supported models & recommended variant

Model	CPU	Recommended variant	Notes
DS920+ / DS1522+ / DS923+	Intel J4125 / R1600	openvino	Intel iGPU + 4-8 streams of 1080p workable
DS423+ / DS224+	Intel N100 / N5105	openvino	Alder Lake-N iGPU, 2-4 streams
DS1621+ / DS1821+ (Ryzen)	AMD V1500B	cpu	No iGPU, slow inference
DS223j / DS723+ (ARM)	Realtek / AMD R1600	Not supported	SkyView is amd64-only for ARM models; Ryzen has no iGPU

2. Prerequisites

1
Confirm DSM version
Control Panel → Info Center → DSM version ≥ 7.2; upgrade first if lower
2
Install Container Manager
Search "Container Manager" in Package Center and install it (it was called Docker in older versions, renamed from 7.2)
3
Create the project directory
File Station → /docker → create a folder named yunkan; the final path looks like /volume1/docker/yunkan/
4
Enable SSH
Control Panel → Terminal & SNMP → Enable SSH; you'll run docker compose over SSH later (the Container Manager GUI doesn't support the devices field)

3. Get the compose file

Pick any one of three ways — download in the browser, wget over SSH, or copy and paste the minimal version by hand:

Download compose.yml

Synology DSM 7.2+ template · openvino variant · fully commented

compose.yml

Or wget directly over SSH on the Synology:

bash

ssh admin@<Synology IP>
sudo -i
cd /volume1/docker/yunkan
wget https://yun-kan.com/compose/synology.yml -O compose.yml

Or copy and paste (minimal version)

If you'd rather not wget, copy the minimal compose below, then vi compose.yml, paste, and save. It runs the same — it just omits the detailed comments.

yaml

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:
      - ./data:/app/data
      - ./recordings:/app/data/recordings
      - /etc/machine-id:/etc/machine-id:ro
      - /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro
    environment:
      - TZ=Asia/Shanghai
      - SKYVIEW_SELF_CONTAINER_NAME=yunkan

compose.yml (minimal, paste and save)

4. Start SkyView

bash

cd /volume1/docker/yunkan
docker compose up -d
# Watch the startup logs (Ctrl-C to exit):
docker logs -f yunkan

Wait about 30-60 seconds for mediamtx + redis + api to be ready, then open http://<Synology IP>:23406/ in the browser to enter the Setup wizard.

5. Ports and firewall rules

On Synology, 80/443/5000/5001 belong to DSM's own web UI by default; SkyView uses the 23406 family (offset into the 2xxxx range) to avoid conflicts. If you've enabled Control Panel → Security → Firewall, you need to allow these 5 ports:

23406/tcp — SkyView web + API (required)
23880/tcp — direct RTSP out (for VLC / third-party NVR)
24214/tcp — HLS (playback + fallback live view)
24215/tcp — WebRTC WHEP signaling
23515/udp — WebRTC ICE (live-view UDP; without it the stream auto-falls back to HLS, latency becomes 2-4s)

6. FAQ

The Container Manager GUI can't set up iGPU passthrough

Container Manager's "Image → Run → Device" has no entry to add /dev/dri. You must use a compose file (this guide) or run docker run --device /dev/dri:/dev/dri ... over SSH.

OpenVINO iGPU fallback on DS920+ / N100 models

Some Synology kernels have incomplete i915 driver support for Alder Lake-N, so the OpenVINO GPU plugin may fail to initialize → it automatically falls back to CPU inference. If the detection startup log contains "GPU plugin failed, falling back to CPU", this is the case — features still work, just a bit slower.

License activation reports SLOTS_FULL

On some models product_uuid is empty in DMI, so the container reads a blank value. SkyView falls back to computing the fingerprint from /etc/machine-id alone, which is usually fine; if activation still fails, email support@yun-kan.com a screenshot of the error code.

Upgrading: DSM Container Manager restricts docker socket access, so the web console's one-click online upgrade is unavailable on Synology (incremental patches still work). Upgrade manually: docker compose pull && docker compose up -d --force-recreate yunkan.