Zum Hauptinhalt springen

Kiosk Setup

A kiosk is a tablet placed in your lobby that allows visitors to check themselves in by scanning their QR code. This page covers how to set up a tablet as an Atrium kiosk.

Hardware requirements​

The kiosk UI is a Progressive Web App (PWA) that runs in any modern browser. Recommended hardware:

  • iPad (9th generation or newer) or Android tablet (10" or larger recommended for comfortable document reading and signature capture).
  • A front-facing camera for QR code scanning.
  • A stable network connection (WiFi or Ethernet via adapter). The kiosk can handle brief offline periods but needs connectivity for normal operation.
  • A tablet stand or enclosure for lobby placement. Locking enclosures are recommended for unattended kiosks.
Browser requirements

The kiosk UI requires a browser with camera access (for QR scanning) and canvas support (for signature capture). Safari on iPad and Chrome on Android both work well. Use the browser's "Add to Home Screen" feature to launch the kiosk as a full-screen PWA without browser chrome.

Pairing a kiosk​

Kiosks authenticate as devices, not as users. The pairing process binds a tablet to a specific site:

  1. Generate a pairing code: In the admin dashboard, a Site-Admin or Tenant-Admin opens the kiosk management section and clicks "Register Kiosk." A 6-digit pairing code is generated with a 10-minute expiry.

  2. Enter the code on the tablet: Open your Atrium instance URL on the tablet and navigate to /kiosk. The kiosk setup screen shows a login form. Enter your tenant identifier, admin credentials, and select the site for this kiosk.

  1. Start the kiosk: After setup, click "Start Kiosk." The tablet enters kiosk mode and shows the standby screen.

Once paired, the tablet stores a long-lived device token (valid for one year). You don't need to re-pair the tablet daily — it stays authenticated until the token expires or is revoked.

Kiosk device token​

The kiosk authenticates with a device token — a JWT bound to the tenant and site. This token has a restricted scope: it can process check-ins, fetch visitor data, submit signatures, and display documents. It cannot access admin functions, configuration, or other sites.

Device tokens can be revoked from the admin dashboard. Revoking a token immediately locks out the kiosk — it will need to be re-paired.

Exiting kiosk mode​

To exit kiosk mode and return to the admin dashboard:

  1. Tap the top-right corner of the kiosk screen 3 times within ~1.5 seconds. This is an intentionally hidden gesture to prevent visitors from accidentally exiting.
  2. An "Exit Kiosk" button appears.
  3. Click it to navigate back to the admin dashboard.

This gesture works on any kiosk screen (standby, scanning, check-in).

Multiple kiosks per site​

You can pair multiple tablets to the same site. Each kiosk operates independently — they share the same configuration (documents, settings) but process check-ins separately. This is useful for lobbies with high visitor volume.

Each kiosk has its own device token and can be managed (revoked, re-paired) individually.