Skip to main content

Set Up Kiosk Settings

Quick Setup

Create a device row first. Then use Enroll Device on that row to generate the QR. Most teams finish this in about 3 minutes.

This guide helps you create Mini MDM device rows, enroll Android kiosks and browser devices, route them to access devices, start a video call to a kiosk device, and manage them from Settings → Kiosk. Kiosk mode supports Android devices and flexible browser devices. Users with mini_mdm:read can view kiosk status. Users need mini_mdm:manage to create rows, enroll devices, and run kiosk actions. The Mini MDM Device ID is the stable row ID for each kiosk record. Use it to match a physical kiosk to one specific device row. AVA saves kiosk routing rows against the Mini MDM Device ID. If you still have older device ID mappings, AVA keeps them when you save. Enrollment now starts with Create Device. Then you choose either a locked-down guest kiosk or a flexible browser device.

Go to: Settings → Kiosk

Quick Reference​

SettingWhat It ControlsStaff Use It For
Kiosk access permissionsControls view-only or management accessDecide who can run device actions
Create DeviceAdds an unfulfilled logical kiosk rowReserve a slot before enrollment
Choose device setupOpens the locked-down or browser device chooserPick the right device type first
Enroll DeviceCreates a one-time QR for a single kiosk rowEnroll one known device slot
Create locked-down deviceAdds a managed guest check-in tabletLock the device into kiosk mode
Create flexible browser deviceAdds a browser-paired staff deviceKeep normal browser access on the device
Mini MDM Device IDShows the stable kiosk row IDTrack one specific kiosk slot
ScopeShows row typeDistinguish Per-device rows
Unlock CodeShows the current unlock codeRecover a locked device
Devices listShows enrolled device status across all pagesCheck health and last sync
Device routingLinks kiosks to access and payment devicesKeep routing up to date
CallStarts a video call to the kiosk device after a warning promptReach a kiosk when staff need help
Auto-refreshing…Polls device updates after QR and actionsConfirm enrollment or action results
Device actionsRestart, lock, unlock, un-enrollRemote control and recovery

Kiosk Permission Access​

PermissionWhat You Can DoWhat You Cannot Do
mini_mdm:readOpen Settings → Kiosk, view device list, view statusesCreate device, enroll, show/copy unlock code, restart, lock, unlock, un-enroll, remove, save routing changes
mini_mdm:manageFull kiosk management accessN/A

If you only have mini_mdm:read, the page stays available in view-only mode. You also see a banner explaining that management permission is required.

Choose Enrollment Flow​

GoalUse this actionScope shown in table
Enroll one known kiosk slotCreate Device then choose Locked-down check-in devicePer-device
Set up a shared staff browserCreate Device then choose Flexible browser deviceFlexible
Remove an unused pre-created slotRemove on an unfulfilled rowPer-device
Enrollment flow

The top card now starts device creation only. You pick the device type in the chooser before the row is created. You generate the QR from the row after the locked-down device exists.

Step-by-Step: Create a Locked-Down Device​

  1. Go to Settings → Kiosk.
  2. In the enrollment card, click Create Device.
  3. In Choose device setup, click Locked-down check-in device.
  4. Optional: enter a label like Front Desk 1.
  5. Click Create locked-down device.

✓ You see a new row with Status: Unfulfilled. ✓ The row shows a Mini MDM Device ID. ✓ The row only shows Enroll Device and Remove.

Step-by-Step: Create a Flexible Browser Device​

  1. Go to Settings → Kiosk.
  2. In the enrollment card, click Create Device.
  3. In Choose device setup, click Flexible browser device.
  4. Optional: enter a device alias like Front Desk Browser.
  5. Click Create flexible browser device.

✓ You see a new browser device row. ✓ Streamliner gives you a one-time verification link. ✓ The link opens the AVA frontend and includes the merchant ID. ✓ You open that link on the physical browser device to pair it.

Merchant context

The verification link now uses the AVA frontend, not the legacy check-in flow. It includes mid so the AVA shell can load the correct merchant first.

Step-by-Step: Enroll a Device​

Factory Reset Required

Enrollment requires a factory-reset device. All data on the device will be erased.

  1. Factory reset the device.
  2. Turn on the device and tap the screen 6 times to open the QR scanner.
  3. On the matching row, click Enroll Device.
  4. Scan the QR in the Enroll Device QR Code modal.
  5. Complete the device setup steps.
  6. Return to Settings → Kiosk and click Refresh.

✓ The row changes to Status: Enrolled. ✓ The row now shows Restart, Lock, Unlock, and Un-enroll. ✓ The QR is one-time use and lasts 3 hours.

Step-by-Step: View the Unlock Code​

  1. Find the Unlock Code card.
  2. Click Show to reveal the code.
  3. Click Copy code to save it.

✓ You see “Unlock code copied”.

Step-by-Step: Manage Devices​

Refresh the List​

  1. Click Refresh in the Devices header.

✓ You see “Refreshed (synced X, removed Y)”. ✓ If your property has many devices, the list loads all pages automatically.

Restart, Lock, or Unlock​

  1. Find the device row.
  2. Click Restart, Lock, or Unlock.

✓ You see “Action completed”. ✓ The page enters Auto-refreshing… briefly to confirm the new device state.

Start a call to a kiosk device​

Before You Confirm

The call modal now shows an amber warning box. It warns you that the call may interrupt guest activity on that kiosk.

  1. Find an enrolled device row.

  2. Click Call.

  3. Confirm the warning in the modal.

  4. Click Start call.

    ✓ Streamliner starts a video call to that kiosk device. ✓ Use this when you need to reach the kiosk from the back office. ✓ The warning reminds you that it may interrupt ongoing guest activity.

Un-enroll a Device​

Un-enroll Resets the Device

Un-enrolling can factory reset the device.

  1. Click Un-enroll.
  2. Confirm the warning.

✓ The device disappears from the list after refresh.

Device Routing​

Use the Device Routing card to connect each enrolled kiosk to the right room access encoder and payment terminals. Saved routing rows use the Mini MDM Device ID as the canonical key. AVA keeps existing aliases, notes, encoder links, and terminal links when it updates older rows.

  1. Scroll to Device Routing.
  2. Make sure at least one kiosk device is enrolled.
  3. Expand a device row.
  4. Choose the linked Room Access Encoder and Payment Terminals.
  5. Click Save mappings.

✓ The device row shows the linked encoder and terminal count. ✓ If no devices are enrolled yet, the card shows an empty state instead of routing rows. ✓ Read-only users can view routing data but cannot edit or save it.

What you see when old device IDs still appear​

What you see: A row still uses the older Android device ID after you save.

Fix:

  1. Click Refresh.
  2. Open the same device row again.
  3. Click Save mappings once more.
  4. Confirm the row now shows the Mini MDM Device ID.

Troubleshooting​

QR code does not generate​

What you see: A red error message after clicking Enroll Device.

Fix:

  1. Refresh the page.
  2. Open Enroll Device on the same row again.
  3. If it still fails, contact support.

Devices list stays empty​

What you see: “No devices enrolled yet.” after enrollment.

Fix:

  1. Click Refresh.
  2. Keep the page open for at least one auto-refresh cycle.
  3. Confirm the device finished setup.
  4. If still empty, refresh once more.

Device routing shows no devices yet​

What you see: The Device Routing card shows “No enrolled devices yet.”

Fix:

  1. Enroll at least one kiosk device first.
  2. Click Refresh in the Devices section.
  3. Return to Device Routing and expand the new device row.

Actions fail​

What you see: “Action failed” after Restart, Lock, or Unlock.

Fix:

  1. Confirm the device is online.
  2. Try the action again.
  3. Refresh the list and check the status.

Call is unavailable​

What you see: The Call button is missing or disabled.

Fix:

  1. Confirm the row is enrolled.
  2. Confirm you have mini_mdm:manage.
  3. Refresh the page and try again.

Row shows only Enroll Device and Remove​

What you see: You only see Enroll Device and Remove on a row.

Fix:

  1. Check Status on that row.
  2. If status is Unfulfilled, this is expected.
  3. Click Enroll Device and complete setup.
  4. Click Refresh and confirm status becomes Enrolled.

Kiosk buttons are disabled​

What you see: Create Device, Show, Copy code, or device action buttons are disabled.

Fix:

  1. Confirm your role includes mini_mdm:manage.
  2. If you only have mini_mdm:read, ask an admin to update your role permissions.
  3. Refresh the page after permission changes.

Auto-refreshing does not clear​

What you see: Auto-refreshing… stays visible longer than expected.

Fix:

  1. Wait 45 seconds to allow the polling window to finish.
  2. Click Refresh once.
  3. If it repeats, check network stability on the kiosk device.

Unfulfilled row never enrolls​

What you see: The row stays Unfulfilled after you scan the QR.

Fix:

  1. Click Refresh.
  2. Open Enroll Device again on the same row.
  3. Confirm you used the right device row.
  4. If it still fails, contact support.

What you see: The browser device opens the wrong app or shows a merchant error.

Fix:

  1. Regenerate the browser device link.
  2. Confirm the link includes mid=<merchantId>.
  3. Open the new link on the physical browser device.
  4. If it still opens the wrong flow, contact support.

Still Stuck?​

Contact success@vouch-technologies.com if:

  • ❌ QR generation fails after several tries
  • ❌ Devices never appear after enrollment
  • ❌ Actions fail for more than 10 minutes

Helpful to include:

  • Device model and serial number
  • Screenshot of the error message
  • Time the issue started