Skip to main content

Android 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 and enroll Android kiosks and browser devices. It also covers iPhone and iPad kiosks. Use Guided Access for local-only iOS use cases. Use dedicated enrollment for supervised iOS kiosks. Use Device Routing to manage room access encoders and payment terminals. Kiosk mode supports Android devices, flexible browser devices, and iOS 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, a flexible browser device, or an iOS path.

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, browser, or iOS 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
iOS Guided AccessShows the local setup tutorial for AVA Check-inPrepare an iPhone or iPad without MDM
Dedicated Device EnrollmentAdds a supervised iPhone or iPad rowManage iOS through Apple Business Manager
SetupStarts ADE or kiosk setup on iOS rowsFinish iPhone/iPad provisioning
Verify and continueChecks an installed app before lock modeRecover a stuck app install
Setup statusShows ADE, app, and lock progressTrack iOS provisioning
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 room access encoders and payment terminalsKeep 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
Set up a supervised iPhone or iPadCreate Device then choose iOS → Dedicated Device EnrollmentPer-device
Use Guided Access on an iPhone or iPadHow to enroll → iOS → Guided AccessLocal only
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.

iOS enrollment

Guided Access stays on the local device. Dedicated enrollment uses Apple Business Manager and Vouch MDM.

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: Create a Supervised iPhone or iPad​

Register First

Contact Vouch support before you create the device row. The iPhone or iPad must be registered in Apple Business Manager first.

  1. Go to Settings → Kiosk.
  2. In the enrollment card, click Create Device.
  3. In Choose device setup, click iOS.
  4. Click Dedicated Device Enrollment.
  5. Enter an optional label and the iPhone or iPad serial number.
  6. Click Create and assign.

✓ Streamliner creates the logical device row. ✓ The iOS setup modal opens and starts ADE setup. ✓ You see ADE Connected, ADE Synced, ADE Profile Assigned, and Ready to Erase iPhone/iPad.

Step-by-Step: Use Guided Access​

Local only

Guided Access keeps the device local. Streamliner cannot remotely install, lock, unlock, restart, or erase it.

  1. Go to Settings → Kiosk.
  2. Click How to enroll.
  3. Click iOS.
  4. Click Guided Access.
  5. Follow the tutorial cards for Home Screen, Guided Access, and AVA Check-in.

✓ You can use AVA Check-in in a local single-app setup. ✓ The device stays outside supervised MDM management.

Step-by-Step: Finish iOS Setup on an Enrolled Device​

  1. Find the iOS device row.
  2. Click Setup.
  3. Click Start kiosk setup or Start setup ADE.
  4. Wait for the status cards to progress.
  5. If the app install stalls, click Verify and continue.

✓ The modal shows license, install, and lock mode progress. ✓ The row reaches Ready when kiosk setup finishes.

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. Kiosk routing now lives here, not on the Room Access page. Legacy-only rows still appear when a kiosk has no MDM, flexible browser, or kiosk-device-model record. 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, or shows a Legacy kiosk pill, 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.
  5. If it still shows a legacy row, keep using the same kiosk record.

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.

iOS setup failed​

What you see: The iOS setup modal shows Setup failed or an Apple license error.

Fix:

  1. Confirm Apple Business Manager is connected.
  2. Confirm the Vouch MDM assignment is active.
  3. Check that Apple Apps and Books has free licenses.
  4. Click Retry setup after you fix the issue.

App stays installing​

What you see: The iOS modal stays on Installing app.

Fix:

  1. Check the iPhone or iPad directly.
  2. Confirm ava.kiosk is already installed or can install.
  3. Click Verify and continue.
  4. Wait for Starting lock mode.

Setup button is missing​

What you see: The iOS row shows Setup required and no Setup button.

Fix:

  1. Click Refresh and wait for Apple enrollment to finish.
  2. Confirm the serial number is correct.
  3. Confirm the device is registered in Apple Business Manager.
  4. Remove the row if you added the wrong device.

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