QNAP Homebridge Manager

Several Homebridges on one QNAP NAS

A QTS app that runs each Homebridge in its own Docker container, with its own address on your home network, and looks after all of them from one page on the QTS desktop.

For x86_64 NAS models with QTS 5 and Container Station. The app’s interface is in Traditional Chinese and Japanese.

Read the street

Each Homebridge is a house. Its drawing tells you how it is doing, without reading a word.

  • 192.168.1.21
    Living room Running Lit windows: it is running.
  • 192.168.1.22
    Garden Update available A parcel on the doorstep: a newer image is waiting. Click it to upgrade.
  • 64%
    Garage Upgrading Scaffolding: it is being rebuilt. The door plate shows the progress.
  • 192.168.1.30
    homebridge-old Not managed yet Grey: a container that already runs on the NAS. Take it over, and the Home app keeps its pairing.
  • Add Homebridge The street always ends with an empty lot. Four steps: name, network, folders, confirm.

What it does

Its own address

Every Homebridge gets a fixed address or one from your router (DHCP), with a fixed MAC address. On the network it is its own device, so HomeKit finds it as usual. While you type an address, the app checks that nothing else uses it.

Upgrades that switch back

The app compares your image with Docker Hub when you open it. An upgrade pulls the new image, recreates the container and watches it. If it does not stay up, the previous container is switched back on, and it stays as a backup you can return to later.

Take over what you have

Homebridge containers you made in Container Station show up on the street. Taking one over keeps its name, address, MAC and folders, so the Home app does not need to pair again.

Safe from a stray click

The containers live on Container Station’s system-docker, which Container Station’s own list does not show, so nobody deletes them there by mistake.

Your folders, untouched

The work folder holds the configuration, plugins and pairing. Mount more shared folders with a folder browser. The app never empties, deletes or changes the ownership of a folder.

Open it by name

One click opens each Homebridge’s own web page, with its port and HTTPS setting. Bind a domain name and the app tells you where it resolves. It never edits your DNS.

See what it is doing

Each Homebridge shows its container log and resource use. Upgrades and changes run in the background and show every step as it happens.

HomeKit keeps running

Containers run on Docker’s restart policy, not as part of the app. Stopping, upgrading or removing the app does not stop a single Homebridge.

Install

  1. Download Homebridge_<version>_x86_64.qpkg from the latest release.
  2. In QTS, open App Center, choose Install Manually and select the file.
  3. The package is not signed by QNAP. If App Center refuses it, allow the installation of apps without a valid digital signature in App Center’s settings, then try again.
  4. Open Homebridge from the QTS main menu.

Or install from an SSH session as an administrator:

sh Homebridge_<version>_x86_64.qpkg

Installing a newer version keeps your settings and leaves running containers alone.

How it works

One Rust program, hbmgr, runs behind the QTS admin web server. It checks your QTS session and speaks to Docker directly over its socket: no Docker CLI, no shell, no PHP. The page is plain HTML, CSS and JavaScript.

Every change can be undone

Applying settings, upgrading and taking over all use the same step, a recreate with rollback:

  1. Stop the current container and keep it as the backup, <name>.hbmgr-prev.
  2. Create the new container with the same address and MAC, and start it.
  3. Watch it for a few seconds.
  4. Keep it, or put the old container back exactly as it was.

Where things live

  • Containers, images and networks: on Container Station’s system-docker.
  • Addresses: Container Station’s qnet network driver.
  • Settings of each Homebridge: a JSON file in the app’s data folder. Containers also carry hbmgr.* labels, so a reinstall finds them again.
  • Your data: in the work folder you chose, never inside the app.

Good to know

  • The containers do not appear in Container Station. Use this app to see them.
  • Uninstalling the app leaves the containers running. Install it again and they show up to be taken over.
  • Reinstalling or resetting Container Station can remove the containers. The work folders survive: create the Homebridge again with the same folder and address, and pairing is kept.
  • Nothing runs in the background. Updates are checked only while the page is open.
  • The app can mount any shared folder, so only QTS administrators can use it.

The details are in the README, the API contract and the interface design.