Pairing the Mobile App
This guide walks you through connecting Fuze Store on your phone or tablet to Fuze Store Hub running on your store computer. Once connected, the device prints receipts, sends kitchen tickets, and updates the customer-facing display in real time — all over your local Wi-Fi, without going through the internet.
You only need this on iPhones and Android tablets. If you use Fuze Store in a web browser, follow Pairing the Browser App instead.
Before you start
Open the Fuze Store Hub app from your dock or system tray. The Hub must be running for any device to connect.
Your phone and the store computer must be on the same network. If your router has separate "Guest" or "IoT" networks, both devices must be on the main one.
Open Fuze Store Hub → Settings → Network → toggle "LAN sharing" ON. This lets the Hub accept connections from other devices on your Wi-Fi (otherwise it only accepts the computer it is running on).
Both operating systems ask apps for permission before they can find devices on your Wi-Fi. On a Mac store computer: System Settings → Privacy & Security → Local Network → allow Fuze Store Hub, then quit and reopen the Hub. On the iPhone/iPad: Settings → Fuze Store → Local Network → ON. Without these, discovery is blocked silently — everything looks fine but the list stays empty.
After the first pairing, the device remembers the Hub. You only walk this flow once per device.
How pairing works (in plain English)
Think of pairing like sharing a Wi-Fi password — but better. You generate a short 8-digit code in Fuze Store Hub, type it into your phone, and the Hub gives your phone a personal key that works only for that phone.
If a phone is lost, you can revoke just that phone's key in Hub → Settings → Network. The other paired phones keep working.
The four steps
1. Find your store computer on the network
On your phone, open Fuze Store → Configurations → Integrations → Fuze Store Hub and tap Connect to your Hub. (If your store has never set up a Hub before, tap Set up a Hub instead — it walks through installing and activating the Hub first, then lands on this same pairing step.)
The app starts looking for Fuze Store Hubs on your Wi-Fi. After a few seconds, your store computer should appear in the list with its name (e.g. "Counter Hub" or your computer's name).
Tap your Hub in the list. The next step opens automatically.
Don't see your Hub? The most common cause on a Mac store computer is the Local Network permission — open System Settings → Privacy & Security → Local Network, switch on Fuze Store Hub, then quit and reopen the Hub (macOS blocks discovery silently when this is off, so the Hub looks fine while phones see nothing). Also check the phone's own permission: Settings → Fuze Store → Local Network → ON. Some networks (especially guest Wi-Fi or networks with strict isolation rules) block discovery too — in that case tap Enter manually and skip to step 2.
2. Enter the Hub address (only if discovery missed)
If you tapped Enter manually, the app shows two text fields:
- Hub IP address — open Fuze Store Hub on the store computer, go to Dashboard, and read the LAN address shown at the top (looks like
192.168.1.42). Type that into your phone. - HTTPS port — usually
18443. Only change this if you customized it in the Hub.
Once both are filled in, the code field below becomes active.
3. Generate and enter the pair code
On the store computer, open Fuze Store Hub → Settings → Network → "Pair the browser" card → Generate code.
An 8-digit code appears with a 5-minute countdown.
Back on your phone, type the 8 digits into the code box. The app submits the code automatically as soon as you type the last digit.
Codes expire after 5 minutes and can only be used once. If you wait too long or mistype, just generate a new one in the Hub.
4. You're paired
You'll see a green Paired card with the Hub's name. The status badge at the top of the app shows Connected with a green dot.
That's it. Receipts, kitchen tickets, and customer display updates now flow through your Hub.
If you want to stop this phone from sending anything to the Hub for a while, turn Use this Hub off on the same screen. The phone stays paired, and queued print or kitchen work waits until you turn it back on.
If you ever want to remove this phone from the Hub completely, tap Disconnect on the same screen.
What the badge colors mean
After pairing, a small badge appears at the top of the app showing the connection status:
Your phone is talking to the Hub. Printing, KDS, and CFD all work over Wi-Fi.
Wi-Fi blip or the Hub restarted. The app retries automatically every few seconds for about 5 attempts before flipping to red.
The phone can't find the Hub on the Wi-Fi. Walk through the troubleshooting steps below.
This phone is still paired, but it is not sending receipts, KDS, customer display, probes, or local sync to the Hub.
This device has not been paired with a Hub yet. Run the wizard above.
Common errors
On a Mac store computer, first check System Settings → Privacy & Security → Local Network — Fuze Store Hub must be allowed (toggle it off and on if it already is), then quit and reopen the Hub. Also confirm the phone's permission: Settings → Fuze Store → Local Network → ON. If both are set, tap "Enter manually" and use the IP address shown on your Hub Dashboard — your Wi-Fi router may be blocking automatic discovery, and manual entry is just as reliable.
Confirm both devices are on the same Wi-Fi (not a guest network). On your store computer, check that "LAN sharing" is ON in Hub → Settings → Network. As a sanity check, open the Hub address (e.g. https://192.168.1.42:18443/health) in your phone's browser — you should see a small text response after accepting a security warning.
Codes expire after 5 minutes and are single-use. Generate a fresh one in Hub → Settings → Network and try again.
The Hub limits failed code attempts to slow down guesses. Wait one minute and try again.
Normal during a Wi-Fi handoff or right after the Hub restarts. If it stays yellow for more than a minute, restart the Hub.
Pairing more devices
Each phone or tablet pairs independently. Generate a fresh code for each one. A Hub keeps up to 32 active device sessions — revoke old ones from Settings → Network → Active sessions if you reach the limit.
You can see every paired device in Hub → Settings → Network. Each row shows the device label, when it was paired, and a Revoke button.
Disconnecting a device
You can disconnect from either side:
- From the phone — open the Pair Device screen, tap Disconnect. The phone falls back to cloud-only mode: Bluetooth printing and Cloud-mode KDS can still work over the internet. USB/network printers, Local-mode KDS, and the Customer Facing Display need the Hub — reconnect to use those.
- From the Hub — open Settings → Network → Pair the browser, find the device row, and click Revoke. The phone will see "Disconnected" and need to be re-paired.
Revoking a device immediately kicks it off the Hub. Use this if a phone is lost or stolen — the next attempt to use it will fail and prompt for a new pair code.