License and activation
Every BoothIQ kiosk has its own license tied to its hardware. In most cases the license is already activated when the kiosk arrives at your venue and you never need to think about it. This article tells you how to check the license status, what trial and grace-period banners mean, and what to do if you see one.
Who this is for: Operators verifying license status during initial setup, or after seeing a license banner appear on the admin dashboard.
Where to find the license status
1. The license banner (top of the admin dashboard)
The admin dashboard has a License Banner strip just below the header bar. It only appears when the license is in a trial or grace-period state. For a normal active license, the banner is hidden and you'll see no message at all.
If you see the banner, read it carefully. It will tell you:
- What state the license is in (trial, grace period, expiring soon)
- How many days are left
- What action you need to take (usually contact support or renew via the cloud dashboard)
2. The License Status card in the Settings tab
For the full picture, open Settings in the admin sidebar and look at the right-column License Status card. The header reads "License Status" with a subtitle "Your license information".
This card shows the detailed license state: the state name, expiration date, subscription tier, and any other metadata your license carries.
Possible license states
A BoothIQ license can be in any of these states:
| State | What it means | Operator action |
|---|---|---|
| Active | The license is valid and in good standing | None. Banner is hidden |
| Trial | A time-limited evaluation license | Plan to convert to a paid license before the trial ends. Contact your BoothIQ point of contact |
| Grace period | The license has expired but the booth is still allowed to run for a short window | Renew the license immediately (cloud dashboard or support contact). The booth will stop accepting customers when the grace period ends |
| Expired | The license has fully lapsed | The booth blocks new customer sessions until the license is renewed. Contact support |
| Revoked | The license has been administratively revoked from the cloud | The booth stops accepting customers. Contact support |
The exact wording on the license banner depends on the state. Read it carefully when it appears.
How licenses are tied to hardware
Each BoothIQ license is bound to the specific kiosk hardware it was issued for. This means:
- You cannot move a license from one kiosk to another by hand.
- The license uses a hardware fingerprint (a stable identifier derived from the kiosk's hardware) to detect if it's been moved to a different machine.
- If the kiosk hardware is replaced (for example, a motherboard swap by support), the license has to be re-issued for the new hardware.
- License operations (issuance, renewal, revocation) happen on the BoothIQ cloud, not on the kiosk.
This is why you, as an operator, never enter a license key by hand on a kiosk. The license is delivered to the booth automatically when it's registered to your cloud account.
Online vs offline activation
BoothIQ licenses can be activated in two modes:
Online activation (the default): When the booth is registered to your cloud account and connected to the internet, it pulls and verifies its license automatically. You don't do anything.
Offline activation: For venues without internet at all, BoothIQ supports offline license files that operators install once. This is an unusual case. If your venue truly has no internet, contact your BoothIQ point of contact and they'll issue an offline license.
A booth running on an offline license still has a grace period built in. If the license file expires and the booth has never been online to refresh it, the grace period buys you time to act.
What to do if the license banner appears
If it says Trial:
- Note how many days are left in the trial.
- Contact your BoothIQ point of contact to convert to a paid license.
- Once payment is processed, the new license is delivered to the booth automatically (you don't do anything on the kiosk).
- The trial banner disappears.
If it says Grace period:
- Act immediately. Grace periods are short.
- Open the cloud dashboard from a separate device and check the booth's billing status.
- If billing is fine and the grace period was triggered by a network outage, just wait. The next successful cloud sync will refresh the license and clear the banner.
- If billing is in arrears, resolve it through the cloud dashboard.
- If you can't figure out why the booth is in grace, contact support with the Booth ID (visible in the Cloud Sync tab).
If it says Expired or Revoked:
- The booth is no longer accepting new customer sessions.
- Contact BoothIQ support immediately. Have your Booth ID ready.
- Don't power-cycle the kiosk hoping the message will go away. License enforcement persists across reboots.
Verify it worked
For a healthy, normal kiosk you should see:
- No license banner at the top of the admin dashboard.
- The License Status card in Settings showing an Active state.
- The booth accepts customer sessions normally.
If any of those is wrong, work the table above.
Common problems
| Symptom | Likely cause | Fix |
|---|---|---|
| License banner appears after a long offline period | The booth couldn't refresh its license from the cloud | Connect the booth to the internet. The next sync will refresh it |
| License Status card shows "Loading..." indefinitely | The license service hasn't initialized yet | Wait 30 seconds and check again. If it persists, restart the kiosk |
| Booth was working yesterday, now refuses sessions with a license error | License silently expired and the grace period elapsed | Re-register or renew via the cloud dashboard, then contact support if it doesn't clear |
What this article does not cover
- License key formats and the cryptography behind activation (see the developer documentation in the BoothIQ source repo).
- Per-tier feature flags (see the developer documentation in the BoothIQ source repo).
- How to issue licenses from the cloud admin side. That's done in the cloud dashboard, not on the kiosk.
Next steps
- Testing your connection. Run an end-to-end test now that everything is connected and licensed.
- Cloud and Fleet › What cloud sync does (coming soon). Understand what the booth pushes and pulls from the cloud.