Skip to main content

🧰 How to check kiosks & in-store devices: setup, verification, and daily checks

End to end kiosk deployment: install, assign content, verify offline readiness, monitor, troubleshoot. Includes screenshots and diagrams.

Leo avatar
Written by Leo
Updated over 5 months ago

1) Prerequisites

Hardware

  • Android 8.0+

  • 8 GB RAM (recommended minimum)

  • 64 GB storage or more

  • Power supply (keep plugged in; supports 8+ hrs battery for cuts)

  • Optional: peripherals (scanners, printers)

Network

  • 10 Mbps+ typical; 30 Mbps+ if video-heavy

  • Absolute minimum 2 Mbps (not recommended)

  • Stable 4G SIM acceptable where Wi-Fi is unreliable

  • Allow outbound HTTPS (TLS 1.2/1.3) and DNS to Merlin Cloud services/CDN

  • Avoid captive portals (pre-authorise devices if used)

Software

  • Merlin Cloud Package + Merlin Cloud Lockdown (installed)

  • Kiosk registered in the dashboard

Mobile (QR) deployments must be online; offline is not supported on mobile.


2) Assign content (campaign → device) (2–3 min)

  1. In Campaigns, create/pick a campaign for a specific Experience Release.

  2. Go to Kiosk Section, Select "Edit" your kiosk(s) and Publish or Schedule (London time).

  3. If the kiosk is offline at start time, it will apply the release on next connect.

One campaign per kiosk at a time. To pause updates for a device, simply exclude it from upcoming releases.


3) Prepare assets for reliable offline (5 min)

  • Optimise images to ≤ 500 KB (WebP recommended)

  • Avoid single files > 1 MB (can slow updates/fail on weak links)

  • Leave several GB free storage for caching

  • Prefer local fallbacks over live external APIs for critical UI


4) Verify offline readiness (3–5 min)

On the Dashboard

  1. Go Devices → [Kiosk]. Status should be Green (heartbeats every 30s).

  2. Confirm the kiosk is included in the latest release.

On the Device

  1. Load the experience.

  2. Disconnect Wi-Fi/WAN.

  3. Confirm the kiosk continues to run UI/media from cache.

  4. Reconnect; within ~15 minutes (or after 60s idle) the app reloads if an update exists.

    Note: the permission to adjust wifi will be available on MerlinCloud Dashboard soon.


5) Monitor health & uptime (ongoing)

Status colours

  • Green: online now (last heartbeat < ~2 min)

  • Yellow: seen within 24 hours

  • Red: offline 24+ hours

Uptime

  • % of time Green in the selected window

Notifications

  • Dashboard bell, Email, SMS

  • Slack & Webhooks available for Enterprise

  • Alerts trigger on transitions to Yellow/Red


6) Use remote actions (when on site or from HQ)

From Devices → [Kiosk] you can:

  • Ping / Beep (locate device)

  • Send screen message

  • Lock / Unlock the screen

  • Enter/Exit Lockdown

  • Adjust volume, brightness, orientation, screen timeout

Behaviour

  • Online: actions execute immediately

  • Offline: actions apply on next connect

Note: These functions will be available soon


7) Analytics capture & syncing

  • Offline queue in localStorage; UUID v4 per session

  • Items delete only after successful insert into the DB

  • We do not store sensitive data locally; sensitive inputs are redacted

  • Default retention on device: 30 days / 1,000 sessions
    (Enterprise: up to 180 days / 100,000 sessions)


8) Security quick facts

  • Transport: HTTPS (TLS 1.2/1.3)

  • Optional at-rest encryption of local cache (Enterprise)

  • End-to-end SSL per device on request


9) Troubleshooting playbook

New content not showing

  • Confirm the device is targeted in the latest release

  • Leave it online for a 15-minute reload cycle (or trigger 60s idle)

  • Re-compress large assets (≤ 500 KB images; avoid > 1 MB)

Device shows old content after reconnect

  • Network: no captive portal; outbound HTTPS/DNS allowed

  • Check free storage for caching

  • Power cycle to restart app & service worker

Analytics missing

  • If the kiosk was offline, queued events upload on reconnect

  • Duplicates are de-duped (most recent wins)

Cold start with no cache

  • Branded “No internet available” splash appears—reconnect or reseed

Need to pause updates

  • Exclude the device from upcoming campaign releases


10) Daily / weekly checklists

Daily (store staff, 1–2 min)

  • Device is Green and interactive

  • Screen brightness/volume appropriate

  • Content looks current; note any load errors

Weekly (ops, 5 min)

  • Verify heartbeat history is continuous

  • Scan alerts; resolve Yellow/Red devices

  • Confirm at least one 15-min reload occurred while online

  • Review asset sizes and package health for upcoming releases

Monthly (IT/ops)

  • OS updates scheduled out of hours

  • Storage headroom remains healthy

  • Spot-check offline behaviour on one kiosk per site

Did this answer your question?