Skip to content

Homebridge on QNAP

shackrock edited this page Dec 30, 2023 · 10 revisions

Step 1: Install Container Station

Install Container Station from App Center. Open the app and create the Docker storage directory as the default, /Container.

Step 2: Create Homebridge Storage Directory

Open File Station and create a new directory named homebridge under /Container.

image

image

Step 3: Create Homebridge Container

In Container Station, go to the Create tab and search for homebridge and click Install next to homebridge/homebridge.

If you are using Container Station 3 (2023 or later), you will see a blue "explore" button at the top that you need to use instead. Be sure to select DEPLOY button for homebridge/homebridge and not the old onzu/homebridge package!

image

Choose the latesttag

image

Step 4: Configure the Container

Name the container homebridge then click the Advanced Settings button:

image

Set Environment Variables

These environment variables should be configured. See Parameters for details on what these environment variables do.

If you are using Container Station 3 (2023 or later), ensure you click "add" 3 times to add the below variables. There are a lot of existing variables you do not need to edit.

HOMEBRIDGE_CONFIG_UI=1
HOMEBRIDGE_CONFIG_UI_PORT=8581
TZ=Australia/Canberra

image

Set Network Mode To Host

Setting the Network Mode to Host is required for Homebridge to work. If you are using Container Station 3 (2023 or later), you will still find this under the networks tab, but you need to click the "CUSTOM" radio button in order to select "host."

image

Set The Volume Mount

Under the Volume From Host section create the following mount:

  • Volume From Host: /Container/homebridge
  • Mount Point: /homebridge

If you are using Container Station 3 (2023 or later), delete the mount point that is auto populated. Instead, select the dropdown next to "add volume" and select Bind Mount Host Path. There, select the folder in the top one, and the "container" should utilize the mount point text /homebridge. Ensure "RW" is selected.

The "Mount Point" must always be /homebridge. If you have multiple Homebridge instances, modify the "Volume from Host" side for each container, but keep the "Mount Point" as /homebridge.

image

Confirm Settings Are Correct

Confirm the settings you selected are correct then click OK to create the container.

image

Wait for image to download and the container to be created:

image

Step 4: View Running Container

Click the Containers tab to view the running Homebridge container.

image

Manage Homebridge

To manage homebridge go to http://<ip of your nas>:8581.

image