Hass.io on Synology DSM (native package)

Tags: #<Tag:0x00007f3f1ba96d28> #<Tag:0x00007f3f1ba96be8>

I’ve built a native Synology DSM package for running hass.io. It is using Docker so that package needs to be installed and running first. It’s been tested on various x64 based versions running DSM 6.1 or more.

Everything is quite straightforward but make sure to create a Shared Folder to use for data storage and select that in the first dialog.

Installation is made trough Synology’s Package Center by adding a manual package (with the file below). Just make sure to install the Docker package first (I’ll try to make even that automatic in a future version).

Installation dialogs:


The hassio-supervisor container will show some warnings during startup, this is normal.

Current issues:

  • Sometimes there are communication issues between Home Assistant and hass.io, with this error message : Unable to load the panel source: /api/hassio/app/entrypoint.js. Restarting the package seems to fix this or follow the fix below.
    Fix (I don’t think it is possible to make this automatic atm)
    1. Stop the package (from Package Center).
    2. Go to the Docker package page and find the hassio_supervisor Container (under the Container tab).
    3. Stop the hassio_supervisor (if it still is running), right click and choose Action -> Clear.
    4. Make sure that the homeassistant container is stopped.
    5. Start the Hass.io package from Package Center.
    6. Wait a minute and make sure that the homeassistant container is started (in the Docker package) or start it manually.
  • Starting addons when using USB devices (there is a partly working patch under testing).
  • The Synology VPN-server package is conflicting with hassio.
  • Upgrading from the hassio_x64-6.1_20190709-1.spk version (a new version is under testing).

Working addons (most addons should work though, just make sure that the addon ports are not already used):

  • Appdeamon, make sure to change port from 5000 as that is the default port of DSM.
  • Plex server, make sure to stop the native package if installed and add shared data locations (check with @a5pire).
  • Nginx with Let’s encrypt support (more info is needed from @dearlk).
1 Like

Great work! I still use your packages without any problem!

So does this get around the python 3.5 issue somehow? Meaning can the latest version of HA be run using this method?

Yes, it will give you the full hass.io experience with all bells and whistles.

1 Like

I am currently running a VM with HassOS on my Synology but I will definitely gives this a try.

The supervisor will that be updated in the same way as the “normal” hass.io installs?

1 Like


What port is needed by default?

Maybe not an issue related to your hassio package, but when I`m trying to install VSCode i got this errormessage:

19-07-10 07:01:15 ERROR (SyncWorker_3) [hassio.docker] Can’t start addon_a0d7b954_vscode: 404 Client Error: Not Found (“linux runtime spec devices: error gathering device information while adding custom device “/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1XZHX4D-if00-port0”: lstat /dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1XZHX4D-if00-port0: no such file or directory”)

One workaround I see is to manually created the symlink and I was then able to start my addons.

Got the same message. I had running homeassistant in a Docker container an the Diskstation. I stopped and removed the container. So I did not get the message anymore.

I was able to install (took more than 10 minutes on a DS916+), but in the UI when I click on hass.io I get this message: Unable to load the panel source: /api/hassio/app/entrypoint.js.

will this work with the usb-ports on the synology so you can connect z-wave usb stick and other peripherals? I’ll need to connect 2 ports for z-wave and power monitoring, and my synology has 2 usb-ports, so should work.

Also, can you update hass.io like you normally would?


Yes it works with USB devices, and yes you can update as usual in hassio.

Fredrik Erlandsson you are a LEGEND


It is kinda magical but try stopping and starting the package. If that doesn’t help send me a pm and we’ll investigate further.

Port 8123.

Dont update hassio plugins, the plugins dont work any more after updating plugins. (I have now 3 plugins who doesnt start anymore) I will test it at my nuc to check if its system related.

At my nuc there is no problem after updating.

Log file hassio at my syno:

19-07-10 17:59:28 ERROR (SyncWorker_0) [hassio.docker] Can't start addon_a0d7b954_vscode: 404 Client Error: Not Found ("linux runtime spec devices: error gathering device information while adding custom device "/dev/serial/by-id/usb-Texas_Instruments_TI_CC2531_USB_CDC___0X00124B0018ED36A9-if00": lstat /dev/serial/by-id/usb-Texas_Instruments_TI_CC2531_USB_CDC___0X00124B0018ED36A9-if00: no such file or directory")

When i want to start the plugin (vscode) in docker i get the error: docker doenst exist.

I will try it without usb-device…

It doesn’t looks to be Synology related perhaps something else in your setup. Have you consulted the hass.io community?

My installation was doing the same thing. I restarted the package a couple of times and nothing changed. But… while working on this my home lost power due to a thunderstorm and when everything came back up, it worked… like magic

Cool beans! Was looking into this a while back and never finished it, would be nice to see it on DockerHub. I personally use portainer to manage my docker stuff on Synology as I have found the Synology docker UI cause more harm then good.

Has anyone had any issues with the add ons? I installed motioneye and node red. Motion eye works fine, but node red won’t start up.

I looked in docker on the Synology, and the containers are there. When I try start the node red container via the docker interface it says image could not be found. But it is there in the images… is anyone else running node red?