Kiosk Setup
Provisioning a new kiosk — hardware check, software install, cloud pairing.
Hardware checklist
- Touchscreen (iPad, Windows touchscreen PC, or Linux kiosk)
- Stripe Terminal reader (paired with Stripe account)
- Service bay hardware (RS-485 controller + compartment locks)
- Power + Ethernet / Wi-Fi
- Mounting hardware
Software install
On the kiosk
- Install Electron kiosk app from
kiosk/build - On first launch, enter the kiosk API key (generated in admin)
- App registers itself with cloud → receives configuration
In admin
- Go to admin → Kiosks → Add Kiosk
- Set location name, service bay count, Stripe terminal ID
- Generate kiosk API key — paste into kiosk app on first boot
Pairing Stripe Terminal
- Add your Stripe Connect account to tenant config (existing Stripe config — no extra step if already set up)
- In Stripe dashboard → Terminal → register the reader's serial
- Enter the reader ID in the kiosk admin config
Service bay mapping
The kiosk controls physical compartment locks via RS-485. Map each bay to a controller address:
- Bay 1 → RS-485 address
01 - Bay 2 → RS-485 address
02 - etc.
The kiosk unlocks a bay when a customer is assigned to it and locks it after they close the door.
Health monitoring
Kiosks send a heartbeat every 30 seconds. If heartbeat stops, the admin dashboard flags the kiosk as offline. An email alert fires if offline for >10 minutes.