Cloud registration

Cloud registration is the step that links your physical kiosk to your BoothIQ cloud account. After registration, 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 are two ways to register: a 6-character Quick Registration code (recommended) and a Manual Registration flow that takes Booth ID, API Key, and URL (for advanced users and recovery).

Who this is for: Operators registering a brand-new kiosk to their cloud account, or re-registering 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 cloud account and access to it from a separate device (laptop, phone, or tablet with a browser).
• You can sign in to admin on the kiosk (see First login and password).

Open the Cloud Sync tab

1. From the welcome screen, 5-tap into admin.
2. Sign in.
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-registered booth it will say Not Registered in an amber/yellow pill.

Path A: Quick Registration (recommended)

This is the simpler path. You generate a 6-character code in the cloud dashboard, then type it into the kiosk.

Step 1: Generate a code from the cloud dashboard

On your laptop or phone (not the kiosk):

1. Open your web browser and sign in to your BoothIQ cloud dashboard.
2. Navigate to Booths (or the equivalent section).
3. Either create a new booth for this kiosk OR open an existing booth entry that doesn't yet have a kiosk linked to it.
4. Click Generate Registration Code.
5. The dashboard displays a 6-character code (uppercase letters and numbers). Keep this screen open. You'll have a limited time to use the code before it expires.

Step 2: Enter the code on the kiosk

Back on the kiosk, in the Cloud Sync tab:

1. Find the Quick Registration card. If it's collapsed, tap its header to expand it.
2. Tap the Registration Code input field. The on-screen virtual keyboard appears.
3. Type the 6-character code from the cloud dashboard. The field auto-uppercases letters.
4. The helper text under the field reads "Enter a 6-character code to enable registration". When you've typed all 6 characters, the Register Booth button becomes active.
5. Tap Register Booth.

Step 3: Wait for confirmation

The booth contacts the cloud, validates the code, and stores the credentials. After a few seconds:

• The status badge at the top of the page changes from Not Registered (amber) to Connected (green).
• The right-column Sync Status card starts showing live sync activity (queue size, last sync timestamp).
• The Quick Registration card may collapse or hide its inputs.

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

Path B: Manual Registration (advanced)

Use this path only if Quick Registration fails or you've been given Booth ID and API Key credentials directly by support.

1. In the Cloud Sync tab, find the Manual Registration (Advanced) card (collapsed by default).
2. Tap its header to expand it.
3. Fill in the three fields:
   • Cloud API URL: the BoothIQ cloud API endpoint. The field has a default value; change it only if your support contact tells you to.
   • Booth ID: the UUID-style identifier from your cloud dashboard.
   • API Key: the secret key. Use the eye icon next to the field to show/hide what you're typing.
4. Tap Test Connection (the secondary button) to verify the credentials work without committing them.
5. If the test passes, tap Save & Connect (the primary teal button) to store the credentials and register.
6. The status badge updates to Connected.

What gets unlocked when you're registered

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

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.
• On the cloud dashboard (separate device), your booth appears in the booth list with an Online indicator.
• 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 booth from cloud sync (for example, selling the booth or moving it to a different account):

1. Open the Cloud Sync tab.
2. Find the red Unregister Booth button (only visible when registered).
3. Tap it. Confirm the action.
4. The booth clears its credentials, the status badge returns to Not Registered, and the booth stops talking to the cloud.

Local data (sales, templates, settings, photos) is not deleted by an unregister. You can re-register at any time with a new code.

Common problems

Next steps

• License and activation. Confirm the booth's license is active.
• Testing your connection. End-to-end check that everything is talking.