Troubleshooting

This page covers the most common issues. If yours isn't here, export a support bundle (see bottom of page) and send it to support.

Can't open the app on Mac

"Fuze Hub cannot be opened because Apple cannot check it for malicious software."

This happens on the first launch of an unsigned build. Right-click the app in Applications and choose Open, then click Open again in the dialog. macOS remembers this choice and won't ask again.

My tablet can't find Fuze Hub

1. Both devices must be on the same Wi-Fi network. Guest networks often block device-to-device traffic — check that.
2. In Fuze Hub, open Settings → Network. Confirm the bind address is 0.0.0.0 and the port is 8080.
3. On the tablet, open Fuze Store → Configurations → Integrations → Fuze Hub and tap Re-pair. Scan the QR code shown in the Hub's dashboard.
4. If still nothing, temporarily turn off your firewall on the Fuze Hub computer. If that fixes it, you need to allow inbound traffic on port 8080 (see the Network section below).

Printer isn't found

USB printer

• Try a different USB port. Some printers are picky.
• Turn the printer off and back on with the USB cable disconnected, then reconnect.
• On Windows, install the manufacturer's driver first.

Network printer

• Make sure the printer has an IP address. Most thermal printers print a self-test page on boot that shows the IP.
• Ping the printer from the Fuze Hub computer: ping 192.168.1.XXX. No response = network issue.
• Some printers need to be added manually by IP — use Add manually on the Printers page.

Receipts print cut off or garbled

• Open the printer's manual and check its paper width — typically 58mm or 80mm.
• In the mobile app, open Configurations → Printers, select the printer, and set Paper width to match.

Kitchen tickets aren't syncing

Open Fuze Hub → Kitchen Display. Check:

• Last error — if there's a message, it usually tells you what's wrong (bad token, no internet, etc.)
• Unsynced — if it keeps growing, your internet is down or the API token is invalid
• Click Force sync now to retry

If the error says unauthorized or invalid token, create a fresh API token in the mobile app and paste it in Settings → Modules.

Firewall settings

If your operating system's firewall is blocking Fuze Hub:

• macOS — System Settings → Network → Firewall → allow incoming connections for Fuze Hub
• Windows — when prompted on first run, check both Private and Public networks
• Linux (ufw) — sudo ufw allow 8080/tcp

Tray icon shows red

The tray icon in the menu bar reflects server health:

• 🟢 Green — everything OK
• 🟡 Yellow — some services degraded (e.g. cloud offline but LAN still works)
• 🔴 Red — the embedded server has crashed

Click the tray icon to open Fuze Hub and check Logs for details. Restart the app if needed.

Still stuck? Export a support bundle