Check that BuiltSync is connected

Read the four status lights on the BuiltSync dashboard, run the connection test, and get a support bundle.

How-toWorks on: WindowsUpdated

Open the dashboard on the store computer: BuiltSync Dashboard shortcut, or http://localhost:9847 in a browser.

The four status lights#

Along the top are four lights. Green is good.

LightGreen meansIf red
CloudBuiltSync can reach the BuiltPOS cloud.Check the internet connection. If it reads Unlinked, the cloud no longer accepts this agent — see Troubleshooting.
MSSQLBuiltSync is connected to your SQL Server.Point at the light to see why. Fix it on the Database page.
ServiceThe BuiltSync Windows service is installed and running.Amber = not installed or stopped. Use the Runtime page.
HeartbeatBuiltSync reported in to the cloud recently.Usually follows a red Cloud light.
BuiltSync dashboard with four green status lights

The badge at the top left shows the mode: LITE, FULL or LOCAL BUILTPOS.

The Overview page#

  • Identity — your Store, Agent ID, Mode and computer name.
  • Last activity — Status shows Running, Paused, or Unlinked - re-claim in BuiltOFFICE.
  • Sync throughput and Last activity show Pushed, Pulled, Last push and Last pull on a Full store. On a Lite store the same boxes show the tunnel instead: Tunnel (Up or Down), Last query, Connected since and Last disconnect. Tunnel: Down means BuiltOFFICE can't read this store right now.

Run the connection test#

  1. Open Diagnostics on the left.
  2. Under Stepped connection test, click Run full test.
  3. It checks DNS → TCP → Auth → Query → Schema in order and shows which step fails.

Schema drift on the same page lists the POS tables BuiltSync expects and which were found. Click Re-check after changes.

Send details to support#

  1. On Diagnostics, under Support bundle, click Download diagnostic bundle.
  2. Attach the zip to your support ticket. Passwords are removed from it.

The Logs page shows recent agent messages. You can search, filter by level and Download.

In BuiltOFFICE#

  • A BuiltSync Lite store shows a yellow strip: "Store data is view only (BuiltSync Lite)…". That is expected.
  • If the agent is offline, Dashboard figures show — with "data unavailable". This is not $0 — the store computer just isn't connected right now. Check that the computer is on and online.

Good to know#

  • Sync → Trigger sync now runs a cycle straight away (Full mode).
  • The dashboard only opens on the store computer itself.

Was this helpful?

Still need help?

Open a ticket from the app

In any BuiltSOFTHUB app, open Help & Support and choose Report a problem. Our replies appear under My tickets.

Email us

Write to support@builtsofthub.com. Tell us the store name and what you were doing when it happened.