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).
Open the Cloud Sync tab
- 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.
- Sign in. On a new kiosk that is the default admin password (see Default credentials), which you should change during first login.
- In the sidebar, tap Cloud Sync (under the SYSTEM section).
- The page opens with the title Cloud Sync and the subtitle "Connect your booth to the cloud for remote monitoring and data sync".
- 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.
Link the booth
Step 1: Show the QR code on the kiosk
In the Cloud Sync tab:
- Find the Link This Booth card. Its subtitle reads "Connect this booth to your cloud account".
- The card shows a QR code on a white plate, with "Waiting for activation..." underneath.
- 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.
Step 2: Scan it with the BoothIQ app
On your phone (not the kiosk):
- Open the BoothIQ app and make sure you are signed in to the account that owns the booth.
- Open the booth you want to link, then its Settings. It needs an active plan.
- Tap Activate booth and choose the subscription you bought for it.
- The camera opens. Point it at the QR code on the kiosk.
- 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.
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:
| Feature | What it does |
|---|---|
| Remote Analytics | View booth stats from the cloud dashboard |
| Notifications | Get alerts on your phone when the booth needs attention |
| Template Sync | Push templates to the booth remotely |
| Sales Reports | Financial summaries in the cloud |
| Photo Backup | Optional cloud photo storage |
| Remote Config | Update 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.
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):
- Open the Cloud Sync tab.
- Find the red Unregister Booth button (only visible when linked).
- Tap it. Confirm the action.
- 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
| Symptom | Likely cause | Fix |
|---|---|---|
| The app says the code is invalid or expired | The QR code on the kiosk timed out | Tap Refresh QR on the kiosk and scan the new code |
| The app says the booth has no subscription | The booth has no active plan | Subscribe the booth in the app or the web dashboard, then scan again |
| The booth you want isn't in the app | You are signed in to a different account | Sign in to the account that owns the booth |
| The app warns that the kiosk already belongs to another booth | The kiosk was linked before | Read 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 scan | Network connectivity dropped on the kiosk | Check Wi-Fi. The kiosk keeps polling; it catches up when it is back online |
| Booth links but Sync Status shows nothing | Sync is paused waiting for activity | Take a test session. The resulting transaction will appear in Sync Status |
Next steps
- License and activation. Confirm the booth's license is active.
- Testing your connection. End-to-end check that everything is talking.