LAN Bridge Setup
The LAN Bridge is a small free helper program from Fuze Store that runs on a computer in your store. It lets Fuze Store talk to USB and Serial printers, and it makes printing from a web browser possible. You only need it for some setups — if you're using Bluetooth or Network (TCP/IP) printers from the mobile app, you can skip this guide.
When you need the LAN Bridge
You need the LAN Bridge if any of these are true:
- You have a USB printer.
- You have a Serial / RS-232 printer.
- You print receipts from a web browser (the Fuze Store dashboard).
- You want faster, more reliable printing in a busy store, even with TCP/IP printers.
You do not need the LAN Bridge if:
- You only use a Bluetooth printer with the mobile app.
- You only use a TCP/IP printer from the mobile app and you're happy with the speed.
What you need
- A computer that stays on during business hours (a dedicated mini-PC, an old laptop, a Raspberry Pi, or your back-office computer).
- The computer must be on the same Wi-Fi or LAN as your POS device(s) and your printers.
- Around 5 minutes for setup.
Installation
Sign in to your Fuze Store dashboard and go to Account → Downloads → LAN
Bridge.
Download the version for your computer's operating system: macOS,
Windows, or Linux.
Run the downloaded file. The first time you launch it, the LAN Bridge will
ask you a few questions in a terminal window.
Enter your Store ID when prompted. You can find this in your Fuze Store
dashboard under Store → Settings.
Enter the Token shown in the same screen. Keep it secret — anyone with
this token can connect to your bridge.
Press Enter to accept the default host (0.0.0.0) and port
(8080) — these work for most setups.
The bridge prints LAN Bridge ready on http://0.0.0.0:8080 when it's
running. Leave the window open (or set the bridge to run as a service —
see below).
Set it and forget it. On Windows you can add the LAN Bridge to your
Startup folder, on macOS to Login Items, and on Linux you can create a
systemd service. That way it starts automatically when the computer boots.
Connect Fuze Store to the bridge
Now tell the mobile app where to find the bridge.
On the LAN Bridge computer, find its local IP address. On Windows open
Command Prompt and type ipconfig. On macOS open System Settings → Network.
On Linux run ip addr. The address looks like 192.168.1.10.
On your POS device, open Fuze Store and go to Store → Preferences → Local
Server.
Enter the LAN Bridge computer's IP address and port (8080 by
default).
Tap Save. The connection badge in the app header should turn green
within a few seconds.
The mobile app sends a small "heartbeat" message to the bridge every 30
seconds to make sure the connection is healthy. If the bridge is unreachable
for too long, you'll see a "LAN disconnected" banner — your prints will
queue and resume when the bridge is back.
Add USB or Serial printers
Once the bridge is connected, you can register USB and Serial printers like this:
In the mobile app, open Store → Printers and tap Add Printer.
Tap Discover USB Printers (or enter the Serial device path
manually). The bridge scans for connected printers and returns a list
showing each device's name, Vendor ID, and Product ID.
Select your printer from the list. The connection fields are filled in
automatically.
Open the printer detail page and tap Test Print. The test page
prints directly through the LAN Bridge — you should see a small receipt
confirming the connection.
For full add-printer instructions, see Connecting a Printer.
Verify the bridge is running
If you ever want to confirm the bridge is alive without using the app, you can run this on any computer on the same network (replace 192.168.1.10 with your bridge's IP):
http://192.168.1.10:8080/health
You should see a small { "status": "ok" } response. If you don't, the bridge is not running or not reachable from that computer.
Common questions
Can I run the LAN Bridge on the same computer as Fuze Store on a browser?
Yes. In that case use 127.0.0.1 (or localhost) as the host in your Local Server settings.
Can multiple POS devices share one LAN Bridge?
Yes. That's the recommended setup — one bridge per store, with all your tablets and counters pointing at it.
What happens if the bridge computer reboots?
Any prints that were in flight resume when the bridge comes back online. New prints attempted while the bridge was down will be in the print queue and flush automatically on reconnect.
Does the bridge need internet?
The bridge itself does not need internet to talk to printers on your local network. It does send a 30-second status update to Fuze Store cloud so the dashboard knows your printers are online — this part needs internet, but losing it does not stop printing.
Keep the LAN Bridge token secret. Anyone on your network with the token
can connect and send print jobs to the bridge.