Docs / Hardware

Install the hardware bridge

One process per venue on a Mac mini. Runs as a user service; connects out to halopos.

The bridge runs once per venue. It is a small Node process that reaches out to the cloud; nothing ever reaches in.

What you need

A Mac mini (M1 or newer, 8GB RAM), or any Linux box with Node 22.
Network access from the bridge to *.halopos.app on port 443.
A bridge token — generated in Admin → Hardware → Bridges.

Install

curl -fsSL https://halopos.app/bridge/install.sh | bash
export HALOPOS_BRIDGE_TOKEN=halopos_bridge_live_...
export HALOPOS_BRIDGE_ID=<uuid-from-admin>
halopos-bridge start

That's it. The bridge polls for print jobs every 2 seconds, sends a heartbeat every 30 seconds, and stays silent otherwise.

Checking the bridge is paired

Go to Admin → Hardware → Bridges. Your bridge should show *Paired* with a recent heartbeat. The Peripherals list shows any printer or drawer the bridge has registered.