-
Notifications
You must be signed in to change notification settings - Fork 46
Troubleshooting
In case, that Homebridge doesn't run as expected, please follow these steps for debugging:
A lot of issues come through multiple Homebridge instances. Conflicts might require you to completely re-setup Homekit on your iOS devices! Always make sure, there's only one Homebridge instance running on your network at once!
Many issues appear because of invalid JSON. Before you open a ticket, please make sure that the syntax is ok. A good way to verify your config is to use the jsonlint.com validator.
Most issues aren't related to this package, nor to Homebridge -- they are created by outdated plugins or wrong configuration. This package focuses on making Homebridge run as easy as possible. So if Homebridge runs without any plugins, enable them step by step until you find out, which plugin creates the error. You should then contact the plugin's creator.
Make sure that ports 5353 and 51826 (both TCP) aren't blocked by your firewall.
To avoid conflicts with other devices, set the DS_HOSTNAME variable in the .env file to your DiskStation's server name (uncomment it first!). The value should exactly match the server name as shown under Synology DSM Control Panel -> Info Centre -> Server name. It should contain no spaces or special characters.
If you're using a non-Synology device, you might need to adjust the paths to your config (/volume1/docker/homebridge).
Before opening a new issue on GitHub, please use the search function to avoid duplicates.