Long time home assistant user here, very familiar with all the nitty gritty details. My main setup is all manual containers on a bare metal debian box, working great.
I recently stood up a secondary system using HA-OS on a mini PC, and trying to do everything as simple and GUI driven as possible. I tried to get z-wave going with a Zooz ZST-10 700 stick I have. Installed the official z-wave JS app and it seems to have trouble starting. Check the logs and see "FATAL: Either 'device' or 'socket' must be configured."
All good, obviously I need to tell the app where the z-wave stick is. The problem is there is no option for this in the configuration tab of the app. Am I missing something? The Z-Wave JS UI app works fine since it sets the serial path within the web UI. My system and stick are working fine, home assistant sees the stick in the hardware info, the z-wave js ui can see it within its own settings and comes up fine, it's just that the official app seems to have no configuration setting for it.
I'm running the latest everything on a very recent clean install, HA-OS version 17.3, HA version 2026.5.3, and Z-Wave JS app version 1.3.0. I know there would be a conflict between the official app and the community Z-Wave JS UI app and only installed the UI app as a troubleshooting measure.
You shouldn't have both Apps installed. The standard Z-Wave JS app now has the UI built-in, just like Z-wave JS UI. Essentially they are the same app. Did you open the standard app UI with the button in the bottom right?
I understand I shouldn't have both apps installed and did not start that way. I can't open the web ui of the official app as it won't start because of that error. I feel like something in the latest version is not set up correctly for new installs and a configuration parameter is missing somewhere in the app/container definitions.
Just to be thorough I uninstalled both apps, checking the box to remove data, and rebooted HAOS. I then installed just the official app, and no change.
Using my own knowledge and a web search, it's obvious that the app needs to know where the USB Z-Wave stick is, but there is no option for this on my fresh install.
I'm completely noobie to Home Assistant, but here what fixed the same problem on my setup:
Settings -> Apps -> Z-Wave JS
Go to Configuration tab
Click the three dots (context?) menu, choose "Edit in YAML"
Add the line device: /dev/ttyUSB0 (The device name might be something else, e.g. ttyUSB1 etc., depending on what other USB-UART devices you have on your system)
