Skip to content

Kiosk tablet (Fully Kiosk) ​

Many households run the hub on a wall or kitchen tablet using Fully Kiosk Browser in fullscreen. The dashboard is a PWA on any device — there is no separate in-app “kiosk mode” on the Lovely Home site itself.

Hub URL: use your household hub everywhere this doc says YOUR_HUB_URL — e.g. https://smith.lovely-hub.com for a customer hub, or https://dashboard.lovely-home.co.uk for the original production home.

See customer-hub-playbook.md for provisioning a new customer hub before tablet setup.


Safe setup order (read before enabling Kiosk Mode) ​

Configure Fully before locking the device. If Kiosk Mode is enabled with no Remote Admin and a forgotten exit gesture, recovery requires Safe Mode or a factory reset.

  1. Install Fully Kiosk Browser and open Settings (swipe from the left edge, or use the menu).
  2. Enable Remote Administration (PLUS):
    • Remote Admin from Local Network → ON
    • Set a strong Remote Admin password
    • Note the tablet IP (router client list, or Fully Device info)
  3. From a Mac/PC on the same Wi‑Fi, confirm: http://{tablet-ip}:2323 opens and accepts the password.
  4. Set Start URL to YOUR_HUB_URL (e.g. https://smith.lovely-hub.com).
  5. Apply the settings checklist below (especially cookie and Web Automation).
  6. Set Kiosk Exit Gesture and Kiosk Mode PIN — write both down.
  7. Only then enable Kiosk Mode.
  8. Test exit gesture and Remote Admin Unlock Kiosk once while you still have access.

Credentials to store offline ​

ItemUsed for
Tablet Wi‑Fi IPRemote Admin http://{ip}:2323
Remote Admin passwordUnlock kiosk, change settings from Mac
Kiosk Mode PINExit kiosk on the tablet
Kiosk exit gesture5 taps / swipe from left / etc.

Optional: Fully Cloud at fully-kiosk.com/cloud for remote management when not on the local network.


Fully Kiosk settings checklist ​

Required for Lovely Home ​

SettingLocationValue
Start URLWeb contentYOUR_HUB_URL
Remote Admin from Local NetworkRemote AdministrationON + password
Enable JavaScriptWeb contentON
Enable Third Party CookiesWeb contentON (first-party cookies still work if OFF)
Kiosk Exit GestureKiosk ModeYour choice (e.g. Fast 5 taps) — document it
Kiosk Mode PINKiosk ModeSet and record (default is often 1234 if empty)
Kiosk Mode Exit by Remote Admin onlyKiosk ModeOFF unless you always use Remote Admin to exit

These cause Cloudflare Access OTP on every refresh if combined with auto-reload:

SettingValue
Web Automation (PLUS)OFF, or no steps that clear cookies/cache
Delete Cookies on Auto ReloadOFF
Delete Webstorage on Auto ReloadOFF
Delete Cache on Auto ReloadOFF — offline guide photos live in this cache

If Auto Reload on Screen On is ON, Delete Cookies on Auto Reload must stay OFF.

Download for offline on House Guide stores the sitter pack in the browser as well as the service-worker cache. Leave Delete Webstorage on Auto Reload and Delete Cache on Auto Reload off, or the tablet loses that pack and asks for an email code when there is no signal. What to expect on the banner: House Guide — Offline behaviour.

There is no single setting named “clear cookies on restart” — Fully uses the Auto Reload + Delete … on Auto Reload options above.

Cloudflare Access (Zero Trust) ​

Set Session duration to 30 days on every Access application that protects the hub:

  • Hub hostname (e.g. smith.lovely-hub.com)
  • Pages hostname (if used)
  • Worker API application

Global session duration in Zero Trust should match. Changing duration applies to new logins after the change.


House Sitter Mode vs Cloudflare Access ​

Two separate sessions apply:

LayerCookieTypical lifetime
Cloudflare AccessCF_AuthorizationZero Trust Session duration (e.g. 30 days)
House Sitter Modelovely_home_device_session~30 days (renews via keepalive)

If the tablet asks for an email login code, that is Cloudflare Access — not the hub owner PIN and not House Sitter Mode. After OTP, sitter mode should resume automatically on app 2.1.0+ without re-enabling in Settings.

The app pings /api/device-session every 6 hours (and when the screen wakes) to renew the sitter cookie.

Log out / log in (Access) ​

There is no logout button in the dashboard. To force a fresh Access session:

  • YOUR_HUB_URL/cdn-cgi/access/logout (e.g. https://smith.lovely-hub.com/cdn-cgi/access/logout)
  • Or https://{team}.cloudflareaccess.com/cdn-cgi/access/logout

Then open the dashboard again and complete OTP once.


Remote Admin (local management) ​

When Remote Admin from Local Network is enabled:

  • URL: http://{tablet-ip}:2323
  • Password: the Remote Admin password (not the Kiosk PIN)

Useful actions:

ActionWhere
Unlock KioskRemote Admin UI (when kiosk locked on tablet)
Load URLOpen logout URL or dashboard
Edit settingsMost Fully options (Kiosk on/off still needs device interaction unless provisioned)
REST unlockhttp://{tablet-ip}:2323/?cmd=unlockKiosk&password={RemoteAdminPassword}

If :2323 does not connect, Remote Admin was never enabled or the tablet is on a different network/VLAN.

Find the tablet IP from the home router → connected devices, if the tablet UI is locked.


Inspecting cookies (troubleshooting OTP loops) ​

Fully has no built-in cookie viewer. Use Chrome DevTools from a Mac:

  1. On tablet: Settings → Web Content → Enable Webview Contents Debugging → ON.
  2. Connect tablet by USB (USB debugging enabled if prompted).
  3. On Mac: Chrome → chrome://inspect/#devices → inspect the Fully WebView for your hub hostname.
  4. Application → Cookies → expect:
    • CF_Authorization — Access session
    • lovely_home_device_session — House Sitter Mode (when enabled)

After login, expiry should be weeks ahead, not “Session” or a few hours. If cookies vanish after screen wake, check Web Automation and Delete Cookies on Auto Reload.


Kiosk exit gestures (on the tablet) ​

Depending on Fully settings, one of these opens the Kiosk PIN dialog:

GestureNotes
Swipe from leftDefault; on Android 10+ hold briefly on the left edge before swiping
Fast 5 tapsAnywhere on screen (Fully in foreground)
Fast 7 tapsUsed in Single App Mode — 5 taps will not work
Double-tap top-left, then double-tap bottom-rightWithin 3 seconds
Long-press BackIf the device has a back button or remote

Default Kiosk PIN is often 1234 unless changed.

If Kiosk Mode Exit by Remote Admin only is ON, on-tablet gestures are disabled — use Remote Admin Unlock Kiosk.


Recovery checklist (locked out of Fully) ​

Use when the exit gesture fails and you cannot reach settings.

1. Remote Admin (if it was enabled earlier) ​

http://{tablet-ip}:2323 → Unlock Kiosk or /?cmd=unlockKiosk&password=...

If :2323 refuses connection, Remote Admin was not enabled — skip to step 2.

2. Try all exit gestures ​

Swipe-from-left (with hold), 7 fast taps, corner double-taps, PIN 1234.

3. Android Safe Mode (normal reboot is not enough) ​

A normal reboot returns straight into Fully because it is the Home app.

  1. Power off completely.
  2. Power on; as the logo appears, hold Volume Down (some devices use Volume Up — check your model).
  3. Confirm Safe mode badge on screen.
  4. Settings → Apps → Fully Kiosk Browser → Uninstall
    Or Settings → Apps → Default apps → Home app → normal Launcher.
  5. Reboot normally.

4. Factory reset (last resort) ​

Recovery mode: power off, then Power + Volume Up (varies by device) → Wipe data/factory reset.

You will reinstall Fully from scratch; use the safe setup order above.


Without Fully Kiosk (fallback) ​

If Fully is uninstalled or broken:

  1. Open Chrome on the tablet.
  2. Go to YOUR_HUB_URL.
  3. Complete Cloudflare OTP once.
  4. Optional: Chrome menu → Install app / Add to Home screen.
  5. Re-enable House Sitter Mode in dashboard Settings if needed.

You lose fullscreen lockdown and Fully-specific power/screen policies until Fully is reinstalled safely.


PDF user guides ​

Appliance manuals open inside the same page (PDF.js canvas rendering). Fully Kiosk cannot reliably open PDFs in a new tab or window, so the app does not offer “Open in new tab” on sitter devices.

If a manual fails to load:

  1. Check the tablet is online and Cloudflare Access is signed in.
  2. Tap Try again on the manual viewer.
  3. Confirm the Worker deploy includes the appliance-manuals API.

Light routines / controls ​

Controls call POST /api/button/VBxx on the Worker. Failures are usually:

  • 401 / 403 — complete Cloudflare sign-in, then tap the control again.
  • 502 / 503 — Virtual Buttons or Worker briefly unavailable; the app retries once automatically.
  • Rate limit — wait a few seconds between taps (duplicate cooldown ~2s, max ~10/min).

Sitters cannot operate Virtual Buttons. Only owners in owner device mode can trigger controls — see worker/src/lib/controlPermissions.js and src/config/controlPermissions.js.