Synology Package for Homebridge Docker
This third-party Synology Package simplifies the process of running Homebridge on devices that support Docker and are running DSM 6.1.3 or later.
This package will deploy the oznu/homebridge image using the recommended settings:
--net=hostis set automatically.
-e TZvariable is set based on your current timezone of your Synology NAS.
-e PUIDvariable is set to the same UID as the user who installs the package in DSM.
-e PGIDvariable is set to the same GID as the user who installs the package in DSM.
-v /homebridgeis setup automatically using the directory chosen by you during installation.
How to install
Step 1: Download the latest
.spk from here: https://github.com/oznu/homebridge-syno-spk/releases/latest
Step 2: Open Package Center in DSM and select the
Manual Install option.
Step 3: Click
Yes when warned about using a package from an unknown publisher.
Step 4: Enter the path where you want Homebridge to store it's config.
Step 5: Complete the wizard. The first time you install may take some time as the latest oznu/homebridge image is downloaded from Docker Hub.
Step 6: Use the Homebridge app icon in the main menu to access the Homebridge UI where you can manage your setup.
The Homebridge Config UI app starts on port
8581. The default username is admin with password admin.
Homebridge can be updated from inside the Config UI. From time to time you may need to upgrade the oznu/homebridge image which can be done by stopping and starting the package in the Synology DSM Package Center.
Adding Additional Packages
Some plugins may require additional packages to be installed which can be done by editing the
startup.sh file will be created in the volume you choose during the setup wizard. The Homebridge UI does not provide a way to edit this file so you'll need to do this using DSM or your own computer's editor.
startup.sh file to install
#!/bin/sh apk add --no-cache ffmpeg ffmpeg-libs
startup.sh file to install
#!/bin/sh apk add --no-cache libpcap-dev
To apply the changes made to the
startup.sh file you need to restart the entire container using the Docker app in DSM.
If you have an issue with the installation of Homebridge using this package please raise an issue on this project's GitHub page. For everything else:
- Docker/Platform Issues: oznu/docker-homebridge
- Homebridge Conifg UI Issues: oznu/homebridge-config-ui-x
- General Homebridge Issues: nfarina/homebridge
- For problems with individual plugins please raise issues on the relevant GitHub project page.
Some users have reported not being able to get Homebridge to work at all on their Synology NAS while Bonjour is activated, see this issue for more details.
Pull requests are welcome.
Setting up for development
See the Synology DSM 6.0 Developer Guide.