Skip to main content
Logo

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

Fuze Store Hub running on your store computer

Open the Fuze Store Hub app from your dock or system tray. The Hub must be running for any device to connect.

Both devices on the same Wi-Fi

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.

LAN sharing turned on in the Hub

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).

About a minute

After the first pairing, the device remembers the Hub. You only walk this flow once per device.

How pairing works (in plain English)

The Fuze Store mobile app showing the Hub Discovery list with a discovered Hub named "Counter Hub" and its local IP address

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

1. Find your store computer on the network

On your phone, open Fuze Store → Configurations → Integrations → Fuze Store Hub → Setup → Pair Device.

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? Some networks (especially guest Wi-Fi or networks with strict isolation rules) block this kind of discovery. Tap Enter manually and skip to step 2.

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

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.

The pair code generation screen in Fuze Store Hub showing an 8-digit code, a QR code, and a 5-minute countdown timer

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

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:

Green — Connected

Your phone is talking to the Hub. Printing, KDS, and CFD all work over Wi-Fi.

Yellow — Reconnecting

Wi-Fi blip or the Hub restarted. The app retries automatically every few seconds for about 5 attempts before flipping to red.

Red — Hub unreachable

The phone can't find the Hub on the Wi-Fi. Walk through the troubleshooting steps below.

Gray — Hub paused

This phone is still paired, but it is not sending receipts, KDS, customer display, probes, or local sync to the Hub.

No badge — Not paired

This device has not been paired with a Hub yet. Run the wizard above.

Five connection badge states shown on the Hub status button in the Fuze Store app: green Connected, yellow Reconnecting, red Hub unreachable, gray Hub paused, and no badge for Not paired

Common errors

My Hub does not appear in the list

Tap "Enter manually" and use the IP address shown on your Hub Dashboard. Your Wi-Fi router may be blocking automatic discovery — that's fine, manual entry is just as reliable.

Connection problem

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.

That code did not work

Codes expire after 5 minutes and are single-use. Generate a fresh one in Hub → Settings → Network and try again.

Too many attempts

The Hub limits failed code attempts to slow down guesses. Wait one minute and try again.

Paired but the badge is yellow

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. There is no limit on the number of devices.

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 (printing and KDS still work, but route through the internet instead of the Hub).
  • 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.