Docs / Troubleshooting

Printer is offline

Most of the time it’s a cable or a DHCP lease.

Check the bridge heartbeat

Admin → Hardware → Bridges. If the bridge itself is *Unhealthy*, fix the bridge first — the printer won't come back until the bridge is reporting.

SSH into the Mac mini and run:

ping 192.168.1.50          # your printer IP
nc -vz 192.168.1.50 9100   # port 9100 should answer

No ping? The printer is off, the cable is out, or DHCP moved it. Ping but no port? The printer is on but not in TCP/IP mode.

journalctl -u halopos-bridge -n 200

Look for escpos-tcp: timeout or star-tcp: connect ECONNREFUSED. The specific driver name tells you which peripheral to look at.

Restart the bridge:

sudo systemctl restart halopos-bridge

Still stuck? Email support@halopos.app with the bridge ID and the last 200 lines of logs.