-
-
Notifications
You must be signed in to change notification settings - Fork 240
Homebridge on Unraid
This guide will show you how to run the oznu/homebridge docker image on an Unraid Server.
- Requirements
- Installing Docker on an Unraid Server
- Step 1: Download Docker Image
- Step 2: Create Container
- Step 3: Managing Homebridge
- Viewing Homebridge Logs
- Connect iOS / HomeKit
- Updating Homebridge
- An Unraid Server setup with
Unraid Server OS 6.x
or above.
Docker is built in to unraid server 6, with a built in Docker Manager.
- From the Unraid Dashboard, go to the
Apps
section and then search for and download the oznu/homebridge image. - Click
Click Here To Get More Results From DockerHub
, so that it pulls in oznu/homebridge.
- From here you will see the docker image
homebridge
byoznu
. - Click Install, this will initial the Create of the Container.
A new container using the oznu/homebridge image will be created once configured.
-
Name your container appropriately and then click
Advanced View
. -
For
WebUI
This field allows you to launch homebridge from Unraid to the Homebridge WebUI. You will want to imput your Unraid Server IP with the Port You select for the Config UI.- Example:
http://192.168.7.206:8584
- Example:
-
Network Type
must beHost
. -
For
Extra Parameters
type in--restart=always
. This is recommended if you want your container to automatically restart after your Unraid Server reboots or if Homebridge crashes.
- Select
Add another Path, Port, Variable, Label or Device
to add the following:Web UI Port
,PUID
,PGID
,Homebridg Config UI
, andConfig UI Port
.
-
Setup Each Below:
-
Config Folder
:-
Config Type
:Path
-
Name
:Config Folder
-
Container Path
:/homebridge
-
Host Path
:/mnt/user/appdata/homebridge
-
Access Mode
:Read/Write
-
Required
:Yes
-
-
Web UI Port
:-
Config Type
:Port
-
Name
:Web UI
-
Host Port
:8581
, The Port you want the Web UI on. -
Default Value
:8581
, Same asHost Port
-
Connection Type
:TCP
-
Required
:Yes
-
-
PUID
:-
Config Type
:Variable
-
Name
:PUID
-
Key
:PUID
-
Value
:1000
-
Required
:Yes
-
-
PGID
:-
Config Type
:Variable
-
Name
:PGID
-
Key
:PGID
-
Value
:1000
-
Required
:Yes
-
-
Homebridge Config UI
:-
Config Type
:Variable
-
Name
:Homebridge Config UI
-
Key
:HOMEBRIDGE_CONFIG_UI
-
Value
:1
-
Required
:Yes
-
-
Config UI Port
:-
Config Type
:Variable
-
Name
:Homebridge Config UI Port
-
Key
:HOMEBRIDGE_CONFIG_UI_PORT
-
Value
:8581
, Same asWeb UI Port
-
Required
:Yes
-
-
To manage Homebridge go to http://<ip of nas>:8581
in your browser. For example, http://192.168.1.20:8581
. From here you can install, remove and update plugins, modify the Homebridge config.json
and restart Homebridge.
The default username is admin with password admin. Remember you will need to restart Homebridge to apply any changes you make to the config.json
.
You should now be able to see the Homebridge
as a new HomeKit accessory in the Apple iOS Home App. You can pair the device using the default pin. You can change the pin by editing the config.json
file.
When using iOS 11 you will need to select Don't have a Code or Can't Scan
and then under the Manual Code heading select the Enter code...
link.
To update to the latest version of Homebridge and the oznu/homebridge container:
- Download the latest version of Homebridge
- On the
Apps
tab, ClickCheck for Updates
- If Updates existing for homebridge container, Unraid Dashboard will display.
- Select
Update
then wait, Unraid Docker managment will do the rest. - If all setup correctly the
homebridge
container will start up as normal.