Troubleshooting

Troubleshooting

When something doesn't work in Spectre POS — a printer won't print, a scan won't go through, the app says it's offline — most fixes live in two places: Settings → Hardware and the Logs screen.

Settings → Hardware

Open the user menu (your avatar, top right) → Settings → Hardware tab. This is where you pair and check the bridge that talks to your physical hardware (printer, scanner, customer display).

The Hardware card shows:

• Bridge URL — the address of the bridge running on your hardware.
• Cashier name — used to identify this terminal in logs.
• Status — a badge that tells you whether the bridge is connected.
• Download bridge APK — downloads the latest version of the bridge app for the Android terminal.

Pair the bridge

1. Tap Pair.
2. The terminal displays a 6-digit code.
3. Type that code back in the app and confirm.

Once paired, Status turns green.

Barcode scanning

Open the Barcode Scanning sub-tab to fine-tune scanner timing, prefix, suffix, and minimum length. The defaults work for most handheld scanners; adjust only if your scanner behaves oddly.

Logs

Open the user menu → Settings → there's a Logs entry. Use it to see what's happening inside the app — sync attempts, hardware events, errors.

You can:

• Search the log entries.
• Filter by log level (info, warning, error).
• See context, timestamp, level, code for each entry.

When you contact support, copying the last few errors from here gives them the fastest path to a fix.

Offline mode

Spectre POS keeps a local copy of your products, customers, and orders. If your internet drops, you can keep ringing up sales — they're stored locally and sync up automatically when you're back online.

While offline:

• New sales are queued locally and show up in Orders after sync.
• The bridge to your hardware (if it's on the same local network) keeps working.
• Card payments through Stripe will not work until you're back online.

Common fixes

• Receipt won't print. Check the Hardware status — if it's not green, re-pair. If green, check the printer's own power and paper, then try printing from the order detail again.
• Scanner stopped working. Open Hardware and confirm the bridge is connected. If you use a USB scanner connected directly to the device, check the Barcode Scanning sub-tab settings.
• The app feels stale or wrong. Open the user menu and tap Clear All Local Data, then sign in again. Only do this when nothing else has worked — it deletes everything cached on this device and re-downloads from the server. (Available on the web app.)
• Sales aren't syncing. Check that you're online and that the Logs screen doesn't show repeated sync errors. If errors persist, contact your store administrator.

When to escalate

If a problem keeps coming back after the steps above, capture:

1. What you were doing.
2. The exact error from Logs (search, copy the entry).
3. The Bridge Status at the time.

…and send that to your store administrator or Spectre support.