Cloud registration

Cloud registration is the step that links your physical kiosk to a booth in your BoothIQ account. After linking, the booth pushes its sales, credit history, and heartbeats up to your cloud dashboard, and you can monitor it (and run remote commands on it) from any phone, tablet, or laptop with a browser.

There is one way to link: the kiosk shows a QR code, and you scan it with the BoothIQ app on your phone while signed in to your account. Nothing is typed on the kiosk and nothing is copied from the dashboard. The same scan also activates the booth's license.

Who this is for: Operators linking a brand-new kiosk to their account, or re-linking after an unregister.

Before you start

  • The kiosk is connected to the internet (see Connecting to Wi-Fi if you haven't done that yet).
  • You have a BoothIQ account and the BoothIQ app installed on your phone, signed in to that account.
  • The booth exists in your account and has an active plan. In the dashboard, open Booths, select Add booth if you haven't already, and subscribe it. A booth without a plan cannot be linked; the scan is refused.
  • You can sign in to admin on the kiosk (see First login and password).
Unlinked kiosk? Use the Activate button
While a kiosk is not linked, the welcome screen shows an Activate button in the bottom right corner, and the kiosk will not move past that screen until it is activated. Tap the button and a window opens with the QR code to scan; that is the quickest path, and it needs no admin sign-in. Skip to Step 2 below. The Cloud Sync tab described next shows the same QR code from inside admin, which is also where you re-link a kiosk later.

Open the Cloud Sync tab

  1. From the welcome screen, tap the top right corner (where the credits indicator sits) 5 times quickly. Tapping the middle of the screen starts a session instead. See Accessing admin.
  2. Sign in. On a new kiosk that is the default admin password (see Default credentials), which you should change during first login.
  3. In the sidebar, tap Cloud Sync (under the SYSTEM section).
  4. The page opens with the title Cloud Sync and the subtitle "Connect your booth to the cloud for remote monitoring and data sync".
  5. At the top right you'll see a status badge. On a never-linked booth it will say Not Registered in an amber/yellow pill.
Screenshot needed
cloud-sync-not-registered.png
Cloud Sync tab in the Not Registered state with an amber badge.

Step 1: Show the QR code on the kiosk

In the Cloud Sync tab:

  1. Find the Link This Booth card. Its subtitle reads "Connect this booth to your cloud account".
  2. The card shows a QR code on a white plate, with "Waiting for activation..." underneath.
  3. Below the code, the How linking works panel lists the same steps you are following here.

The QR code encodes only the kiosk's hardware identity. It expires after 15 minutes; if it does, tap Refresh QR and a new one appears.

Screenshot needed
cloud-sync-link-this-booth.png
Link This Booth card showing a QR code, the Waiting for activation status, and the How linking works panel.

Step 2: Scan it with the BoothIQ app

On your phone (not the kiosk):

  1. Open the BoothIQ app and make sure you are signed in to the account that owns the booth.
  2. Open the booth you want to link, then its Settings. It needs an active plan.
  3. Tap Activate booth and choose the subscription you bought for it.
  4. The camera opens. Point it at the QR code on the kiosk.
  5. The app confirms which booth is being linked. If the kiosk was ever linked to a different booth, the app tells you what will happen to that booth's data before you confirm.

Step 3: Wait for confirmation

The kiosk polls for the result. Within a few seconds:

  • The status badge at the top of the page changes from Not Registered (amber) to Connected (green).
  • The Link This Booth card changes to "This booth is linked to the cloud. Use Unregister below to link a different booth."
  • The right-column Sync Status card starts showing live sync activity (queue size, last sync timestamp).
  • The booth's license is active. If the admin dashboard was showing a license banner, it clears.

If the badge stays amber and shows an error, see Troubleshooting › Cloud sync not working.

There is no manual path
Earlier BoothIQ software had a typed registration code and a manual Booth ID / API key form. Both are gone: the kiosk has no code-entry screen and no camera-based scanner. If a support contact asks for your booth's API key, it is in the web dashboard under Settings › Connection Details, but it is never needed to link a booth.

What gets unlocked when you're linked

The Cloud Sync tab includes a Cloud Features card showing six features that activate once your booth is connected:

FeatureWhat it does
Remote AnalyticsView booth stats from the cloud dashboard
NotificationsGet alerts on your phone when the booth needs attention
Template SyncPush templates to the booth remotely
Sales ReportsFinancial summaries in the cloud
Photo BackupOptional cloud photo storage
Remote ConfigUpdate settings remotely

You don't have to use all six. They're available, but the booth runs fine using only the ones you care about.

Screenshot needed
cloud-sync-features-grid.png
Cloud Features card showing the 3x2 grid of available cloud capabilities.

Verify it worked

You're done when:

  • The status badge at the top of Cloud Sync says Connected in green.
  • The Sync Status card on the right shows recent sync activity.
  • In the BoothIQ app and the web dashboard, the booth shows as Online.
  • A few minutes later, the Last Sync timestamp on the kiosk updates to a recent time.

Unregistering a booth

If you need to disconnect the kiosk from its booth (for example, moving the kiosk to a different booth or account):

  1. Open the Cloud Sync tab.
  2. Find the red Unregister Booth button (only visible when linked).
  3. Tap it. Confirm the action.
  4. The kiosk clears its credentials, the status badge returns to Not Registered, and the Link This Booth card shows a fresh QR code.

Local data (sales, templates, settings, photos) is not deleted by an unregister. To link again, scan the new QR code from the app. Selling the booth to another operator is a different flow: use Transfer booth in the dashboard so the buyer inherits it, rather than unregistering.

Common problems

SymptomLikely causeFix
The app says the code is invalid or expiredThe QR code on the kiosk timed outTap Refresh QR on the kiosk and scan the new code
The app says the booth has no subscriptionThe booth has no active planSubscribe the booth in the app or the web dashboard, then scan again
The booth you want isn't in the appYou are signed in to a different accountSign in to the account that owns the booth
The app warns that the kiosk already belongs to another boothThe kiosk was linked beforeRead the warning: linking it here moves the kiosk and clears the old booth's local history. Confirm only if that is what you want
Kiosk stays on "Waiting for activation..." after a successful scanNetwork connectivity dropped on the kioskCheck Wi-Fi. The kiosk keeps polling; it catches up when it is back online
Booth links but Sync Status shows nothingSync is paused waiting for activityTake a test session. The resulting transaction will appear in Sync Status

Next steps