← All projects

Gantry

Connect UniFi Protect to HomeKit in 90 seconds flat.

Install it, sign in to Protect once, scan the code in the Home app. Every camera, doorbell and sensor shows up, and Gantry keeps running in the background until you tell it to stop.

Devices (12)
Overview
Doorbell rec on
Driveway rec on
Porch rec on
Backyard rec on
Garage rec on
Side Gate Light off
Patio 10.5 °C
Back Door closed
Every camera

Detections

Three steps. Then you’re done.

There is no config file to write and no plugin to find. From a fresh install to cameras in the Home app takes about a minute and a half.

  1. 0:00

    Install it.

    With Homebrew, or with the install script, which checks the download against its published checksum.

    brew install ultradotdev/tap/gantry

    or

    curl -fsSL https://ultra.dev/gantry/install.sh | sh
  2. 0:20

    Sign in to Protect once.

    Make a local-access-only account for Gantry in UniFi OS, with View Only access to Protect (or Full Management if you want to control floodlights), then run setup. It confirms your console’s certificate, saves the password to your Keychain and installs the service, which asks for your Mac password once.

    Asked about Local Network access? Here’s what to do.

    gantry setup
  3. 1:00

    Scan the code in Home.

    Open the dashboard and add the bridge in the Home app under Add Accessory › More Options. Every camera, doorbell and sensor comes across.

    gantry

You’ll need a Mac on macOS 14 or later (Linux support is coming very soon), a UniFi Protect console on the same network, and FFmpeg (brew install ffmpeg). Recordings need a home hub and iCloud+, as with any HomeKit Secure Video camera.

Practically nothing to attack.

A HomeKit bridge sits inside your network with the keys to your cameras. Every package it depends on, and every update those packages ship, gets the same access. Locking down the machine doesn’t help when the attack arrives in code you chose to install. So Gantry keeps the list of things you have to trust as short as it can be.

6 MB
One compiled Rust binary
1
Dependency: FFmpeg
0
Web ports open

A typical Node.js bridge

  • A Node.js runtime and a web server for the admin page
  • A plugin for your cameras, with its own tree of npm packages
  • Updates that pull in third-party code nobody reviews
  • A login page on your network that anyone can find

Gantry

  • One compiled binary, about 6 MB
  • FFmpeg for video. That’s it
  • Nothing fetched or added after you install it
  • No web interface. Nothing listening for a browser

No web ports to scan.

There is no admin page, so there is no login to brute-force and no web server to patch. The dashboard runs in a terminal: on the Mac itself, or over SSH from anywhere you can reach it.

Your password stays in the Keychain.

By default Gantry never writes it to disk. After a restart, gantry unlock hands it over from your Keychain and the service holds it in memory only. It talks only to the console certificate you confirmed at setup.

Wall it off as far as you like.

It needs your Protect console and your Apple home on the local network, and nothing else. Give it its own VLAN, keep it off the internet, and leave it there.

Update only when Protect does.

There are no plugins to keep current and no package tree to audit. Unless Ubiquiti changes the Protect API, the version you installed keeps doing its job like clockwork.

It’s light, too. A small memory footprint, video handled on the GPU, and a service that starts at boot and keeps running.

Management is a keypress.

Simple doesn’t mean fixed. The dashboard handles the changes people actually make, right in the terminal, and Home picks them up instantly.

rRename a camera
Give it the name you want to see in the Home app.
sShare or hide a device
Take a camera out of Apple Home, or put it back, in a second.
1–4Choose which detections come through
Person, vehicle, animal and package sensors, set globally or by camera.
P SPrefix or suffix every name
Keep a whole site’s cameras grouped together in Home.

What comes across

  • Live view with sound, open in about a quarter of a second
  • HomeKit Secure Video recordings, with your home hub’s analysis
  • Doorbell presses, two-way talk and package cameras
  • Motion, plus the people, vehicles, animals and packages Protect sees
  • Contact, temperature, humidity, light, leak, battery and tamper sensors
  • Floodlights: on, off and brightness*

* Floodlight control needs a Protect account with Full Management. Everything else works with a View Only user.

Day to day

gantry
Open the dashboard
gantry unlock
Hand the service your Protect password after a restart
gantry service status
See what is installed and running
gantry logs -f
Follow the log

Good to know.

What access does the Protect account need?

View Only is all you need for cameras, doorbells, sensors, motion and recordings, and it keeps Gantry from changing anything on your console. Give the account Full Management only if you want to change the state of Protect devices from the Home app, such as controlling floodlights. Either way, make it a local-access-only account used just for Gantry.

What happens when the Mac restarts?

The service starts at boot and waits for you to run gantry unlock (locally or over SSH). For a machine that has to come back with nobody there, you can put the password in a file readable only by you instead. That trades some safety for convenience, so it’s off by default.

Does it run on Linux?

Not yet, but it’s next. Linux support is coming very soon. For now Gantry runs on macOS 14 or later.

Setup is waiting on Local Network access. What do I do?

macOS blocks new apps from reaching devices on your network until you allow them. Open System Settings › Privacy & Security › Local Network and turn on Gantry. Setup carries on by itself, and the service connects within seconds without a restart.

Does it replace Homebridge?

For UniFi Protect, yes. That’s the one job, and we want it done well before anything else. Chimes, smoke and CO alarms, and Protect’s sound detections aren’t published yet.

Does this make my network secure?

No single tool does that. Gantry cuts your supply chain attack exposure by consolidating a core function into a stupidly simple Rust binary with only one dependency. No more compromised Node packages. Keep the Mac updated, limit who can log in to it, and treat it like any device with access to your security system.

How do I remove it?
  1. Run gantry service uninstall. For the default system service it asks for your Mac password, or prints a sudo command to run yourself.
  2. Delete ~/Library/Application Support/gantry. It holds the config, the HomeKit pairing, your dashboard choices, the log, and the copy of the program the service runs.
  3. If you saved the Protect password to your Keychain, delete the gantry-protect item in Keychain Access.
  4. Remove the Gantry bridge in the Home app.
  5. If you installed with Homebrew, run brew uninstall gantry.