Fix BuiltSync problems

What to do when the claim fails, the MSSQL light is red, the agent shows Unlinked, the service won't start, or BuiltOFFICE shows "data unavailable".

TroubleshootingWorks on: WindowsUpdated

Start on the store computer: open http://localhost:9847 and look at the four lights. Then find your problem below.

The dashboard won't open#

The BuiltSync service is stopped. Double-click the BuiltSync desktop shortcut and click ▶ Start Agent, then Open Dashboard. If it still won't start, restart the computer.

Claiming fails#

  • "Token must start with BSYNC-" — paste the whole token, with nothing before it.
  • "Invalid or already claimed token" — the token was mistyped or already used. Each token works once. Ask support or your reseller for a new one.

The MSSQL light is red#

Point at the MSSQL light to see the reason, or open Database. Common messages:

  • "Connected, but this SQL login cannot read …" — the login has no read access. In SQL Server Management Studio give it db_datareader on the POS database (Security → Logins → the login → User Mapping), or use sa.
  • "login is read-only … BuiltOFFICE edits will fail" — only matters on a Full store. Add db_datawriter.
  • "Login failed for user …" — wrong username or password.
  • "SQL Server is in Windows-Authentication-only mode…" — turn on SQL Server and Windows Authentication mode on the server (SQL Server properties → Security), restart SQL Server, then set up again.
  • "sqlcmd not found…" — Windows Authentication needs the SQL Server command-line tools. Install them, or use SQL Server Authentication.
  • "Could not create the BuiltSync SQL login…" — the Windows account BuiltSync runs as is not a SQL sysadmin. Use SQL Server Authentication with a login that has access.
  • "table(s) … not found" — you picked the wrong database. Choose the POS database.
  • Can't reach a named instance (SERVER\INSTANCE) — start the SQL Server Browser service, or give the instance a fixed port 1433 and leave Instance blank. Steps in Connect your SQL Server.

Change the database settings#

  1. Open Database. The settings are locked.
  2. Click 🔒 Locked to unlock them.
  3. Change Server, Instance, Database, or the username and password.
  4. Click Test connection. Save only works after a passing test.
  5. Click Save. BuiltSync reconnects straight away.

If you change the server, instance or user, type the password again. A store set up with Windows Authentication can't move to another server from this page — choose SQL Server Authentication, or re-claim (below).

Stepped diagnostic test (live connection) under the form, or Diagnostics → Run full test, shows which step fails.

The Cloud light says "Unlinked"#

The cloud no longer accepts this agent — for example the store was switched to another setup. Get a new claim token, then on Advanced click Re-claim and go through setup again.

The Cloud light is red#

The computer can't reach the internet, or a firewall blocks outgoing secure web traffic. Check the connection. BuiltSync reconnects by itself when it's back.

"Service not installed" after Finish#

  1. Open Runtime.
  2. Click Install as service, then Start.
  3. If that fails, sign in to Windows as an administrator and try again.

Until the service runs, BuiltSync stops when you sign out of Windows.

Finish didn't move on to "BuiltSync is running"#

Setup saved your settings but couldn't connect to SQL Server. Click ← Back to the Authenticate step to read the reason, fix it, and click Finish and start syncing again. Or close the wizard and fix it on the Database page.

BuiltOFFICE shows "—" or "data unavailable"#

The store computer is off, asleep, offline, or BuiltSync is stopped. On a Lite store BuiltOFFICE needs the computer to be on. Check the four lights on the dashboard. Turn off sleep on that computer.

Saving in BuiltOFFICE doesn't work#

A Lite store is view only. Make changes on the store's own POS. See Lite vs Full.

Something asks for a dashboard token#

Someone set a Dashboard token on the Runtime page. Paste it into Unlock this browser and click Unlock.

Start over#

On Advanced → Reset & recovery:

  • Reset state — re-sends everything on the next cycle (Full mode).
  • Re-claim — clears the link; you need a new claim token.
  • Factory reset… — clears all settings except logs. You type the store ID to confirm.

Still stuck? On Diagnostics click Download diagnostic bundle and send it to support.

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.