Free
Dauerhaft nutzbarer Web-Kiosk ohne Werbung und Zeitlimit. Das sichtbare Free-Watermark bleibt aktiv.
KioskPilot Handbuch
Einrichten. Verstehen.
Zuverlässig betreiben.
Die vollständige Anleitung für den lokalen Kiosk, Pro-Funktionen und Fleet Cloud – mit klaren Plattformgrenzen und praktischen Schritten.
Grundlagen
So ist KioskPilot aufgebaut.
KioskPilot trennt den lokalen Kioskbetrieb bewusst von Konten und Cloud. Ein einzelnes Gerät kann ohne Konto starten. Ein Portal-Konto organisiert Menschen, Geräte und Abrechnung; es ist selbst keine Geräte-Lizenz.
Pro – pro Gerät
Entfernt das Watermark und aktiviert professionelle lokale Funktionen für genau ein Gerät beziehungsweise eine gebundene Installation.
Fleet Cloud
Separates Angebot für zentrale Verwaltung, Teams, Gruppen, Health, Rollouts und Support. Es ersetzt keine Pro-Gerätelizenz.
Kundenportal
Verwaltet mehrere Nutzer, Geräte, freie und zugeordnete Lizenzplätze, Rechnungsanschriften und Dokumente.
Merksatz: Nutzer verwalten Geräte. Lizenzen gelten je Gerät. Fleet verwaltet die Flotte.
In drei Schritten
Erste Einrichtung.
Für den lokalen Start brauchst du nur deine Zielseite, eine sinnvolle Sicherheitsgrenze und eine Admin-PIN.
- Startseite festlegen. Verwende HTTPS oder eine private LAN-HTTP-Adresse. Öffentliche HTTP-Ziele werden nicht akzeptiert.
- Domains erlauben. Der Host der Startseite muss enthalten sein. Ergänze weitere Hosts nur, wenn die Webseite sie wirklich für Navigation benötigt.
- PIN und Verhalten wählen. Lege Admin-PIN, Wachhalten, Reload, Ausrichtung und optionale Displayzeiten fest. Teste danach die Seite und starte den Kiosk.
Start-URL
Die feste Seite, zu der Home, Autopilot und Offline-Wiederherstellung zurückkehren.
Domain-Allowlist
Prüft Hauptnavigation, Pop-ups, Scanner-, NFC- und Launcher-Webziele.
Admin-PIN
Schützt lokale Einstellungen. Sie sollte nicht an öffentlich zugänglichen Geräten sichtbar aufbewahrt werden.
Verbindungstest
Hilft, DNS-, Netzwerk-, Zertifikats- und Allowlist-Probleme vor dem Kioskstart zu erkennen.
Web-Inhalte
Browser & Navigation.
Der Kiosk-Browser ist kein allgemeiner Browser: Er zeigt deine konfigurierte Anwendung und begrenzt unerwartete Auswege.
User-Agent & Zoom
Wähle mobiles, Desktop- oder eigenes Browserprofil sowie Seiten- und Textzoom. Nutze Custom User-Agent nur, wenn die Zielseite ihn benötigt.
Pop-ups
Nur nach einer Nutzergeste und nur für erlaubte Hosts. Zulässige Ziele werden kontrolliert in das Hauptfenster umgeleitet.
Datei-Uploads
Verwenden die System-Dateiauswahl und können per Policy deaktiviert werden.
Web-Berechtigungen
Kamera, Mikrofon und Standort sind getrennt, standardmäßig aus und nur für erlaubte Hosts verfügbar.
Cookies & Mixed Content
Third-Party-Cookies und LAN-Mixed-Content sind separate, standardmäßig deaktivierte Kompatibilitätsoptionen.
Basic Auth
Benutzername kann konfiguriert werden; das Passwort liegt verschlüsselt im Android Keystore beziehungsweise Apple Keychain und fehlt in Exporten.
Nicht übersteuerbar: SSL-Zertifikatsfehler und Safe-Browsing-/Fraud-Warnungen werden niemals ignoriert.
Gerät & Anzeige
Display, Screensaver & Launcher.
Wachhalten & Ausrichtung
Hält die Anzeige während des Kioskbetriebs aktiv und fixiert Hochformat, Querformat oder Systemausrichtung soweit die Plattform es erlaubt.
Helligkeit & Nachtplan
Definiert Tages- und Nachthelligkeit mit Start- und Endzeit. Das Betriebssystem kann harte Mindestwerte vorgeben.
Pixel Shift
Verschiebt statische Inhalte minimal und reversibel, um dauerhafte Belastung gleichmäßiger zu verteilen.
Screensaver
Schwarz, Uhr oder eigene Nachricht nach Inaktivität. Eine Berührung kehrt zum Kiosk zurück.
Universal Launcher
Zeigt freigegebene Webseiten und Apps als Kacheln. Webziele bleiben an die Allowlist gebunden.
Scanner & NFC
QR, Barcodes und NDEF-Ziele werden gelesen, validiert und erst danach geöffnet. Unterstützte Formate unterscheiden sich nach Gerät.
KioskPilot Intelligence
Autopilot, Offline Rescue & Schutz.
Kiosk Autopilot
Überwacht Laden, Netzwerk und Renderer. Eskalation: Reload, Home, WebView-Neustart, Offline Rescue und – bei Fleet – technischer Diagnosezustand.
Offline Rescue
Lokale Ersatzseite mit verständlicher Meldung. Sobald die Startseite erreichbar ist, erfolgt der kontrollierte Rücksprung.
Privacy-Modus
Löscht nach Inaktivität Cookies, Web Storage, Formular- und Browserverlauf und startet eine frische Sitzung.
Accessibility Check
Prüft lokal Touch-Ziele, Beschriftungen, Überlauf, Skalierung sowie grundlegende Kontrast- und Schriftindikatoren.
Display-Schutz
Kombiniert Pixel Shift, Helligkeitsplan sowie technische Temperatur- und Akkuhinweise, soweit das Gerät sie liefert.
Temporärer Support
Einmaliger, kurzlebiger Code; sichtbare Zustimmung am Gerät; begrenzte Rechte; automatisches Ende und Audit-Eintrag.
Datensparsam: Accessibility- und Autopilot-Analyse laufen lokal. Fleet erhält nur technische Zustände und Zähler, keine DOM-Inhalte oder Formulareingaben.
Smart Home
Home Assistant & Integrationen.
KioskPilot kann ein lokales Home-Assistant-Dashboard direkt finden und professionell integrieren.
- Quick Setup starten. KioskPilot sucht `_home-assistant._tcp.local.` im lokalen Netz.
- Instanz auswählen. Die gefundene interne Adresse wird als Startseite übernommen und der Host erlaubt.
- Optional Pro integrieren. Lokale API oder TLS-MQTT aktivieren und Home-Assistant-Discovery publizieren.
Lokale API · Pro
Private Netze, zufälliges Bearer-Token. Status lesen sowie Reload, Home, Privacy Reset, Launcher und Helligkeit auslösen.
TLS-MQTT · Pro
Nur `ssl://`/`mqtts://`. Veröffentlicht minimierten Status und akzeptiert definierte Befehle. Passwort wird nicht exportiert.
Discovery
Kann Online-Sensoren und Aktionen wie Reload oder Home automatisch in Home Assistant bekannt machen.
LAN-Sicherheit
Die HTTP-LAN-API schützt per Token, verschlüsselt aber nicht. In nicht vertrauenswürdigen Netzen TLS-MQTT oder Fleet verwenden.
Lizenzierung
Free, Pro & Lizenzstatus.
Pro gilt genau für das aktivierte Gerät oder die kryptografisch gebundene Installation. Das Portal zeigt freie und zugeordnete Plätze; es macht aus einer Nutzerlizenz keine Mehrgeräte-Lizenz.
Free
- Lokaler Web-Kiosk
- Grundlegender Autopilot
- Offline Rescue
- Quick Setup und Accessibility Check
- Sichtbares Watermark
Pro
- Kein Watermark
- Erweiterte Autopilot-/Privacy-Funktionen
- Lokale API und TLS-MQTT
- Device Owner / Managed Policies
- Eine Lizenz je Gerät
Käufe wiederherstellen
Fragt den Store erneut nach aktiven Käufen und stellt das lokale Entitlement wieder her.
Vollständig synchronisieren
Leert widersprüchliche lokale Lizenz-Caches und baut den Status aus Store und Control Plane neu auf. Der Kauf selbst wird nicht gelöscht.
Store-Grenze: Portal-Lizenzplätze und Store-Käufe sind fachlich getrennt. Eine neue Portalzuordnung verschiebt einen Store-Kauf nicht automatisch auf eine andere Installation.
Plattformen
Android und iOS/iPadOS.
Android · normal installiert
Immersiver Vollbildmodus und Screen Pinning, jedoch mit Systemgrenzen. Ein Nutzer kann je nach Gerät den systemeigenen Kiosk verlassen.
Android · Device Owner
Dedicated-Device-Betrieb mit Lock Task, Enterprise-Policies und zuverlässigerem Startverhalten. Erfordert korrekte Provisionierung.
iPhone/iPad · privat
Guided Access ist der praktikable Single-App-Weg. Eine normale App darf das Gerät nicht selbst vollständig sperren oder nach Neustart starten.
iPhone/iPad · betreut
Apple Configurator oder MDM kann Single App Mode/App Lock und Managed Configuration für betreute Geräte einsetzen.
Funktionsgleich bedeutet gleiche Produktwirkung: Android nutzt Device Owner; Apple nutzt Guided Access oder MDM. Betriebssystem-Sicherheitsmechanismen werden nicht umgangen.
Zentrale Verwaltung
Fleet Cockpit & Kundenportal.
- Organisation und Nutzer. Owner, Admin, Operator und Read-only teilen klar begrenzte Rechte.
- Gerät koppeln. Im Portal einen kurzlebigen Pairing-Code erzeugen und sichtbar in der App bestätigen.
- Lizenz zuordnen. Einen freien Pro-Platz genau einem eigenen Gerät zuweisen. Freigabe macht ihn wieder verfügbar.
- Betrieb organisieren. Geräte benennen, gruppieren, überwachen und Konfigurationsrevisionen kontrolliert ausrollen.
Übersicht
Geräteanzahl, Online-Zustand, Warnungen, Lizenzbelegung und zentrale Handlungsbedarfe.
Geräte
Pairing, Start-URL, Allowlist, technische Details, Revision, Support-Code und Widerruf.
Lizenzen
Gesamt, zugeordnet und frei. Jede Zuordnung bleibt gerätegebunden.
Abrechnung
Versionierte Rechnungsanschriften, unveränderliche Direktrechnungen und getrennte Store-Belege.
Team
Einladungen sind einmalig und 48 Stunden gültig. Das Mitglied wählt sein Passwort selbst.
Konto
Passwort, TOTP-MFA, Recovery-Codes, aktive Sitzungen und Abmeldung.
Sicherer Betrieb
Health, Incidents & Rollouts.
Fleet Health
Bewertet Heartbeat, Fehlerzustand und technische Signale anhand konfigurierbarer Schwellwerte. Warnungen können bestätigt und automatisch aufgelöst werden.
Geräteaktionen
Reload, Home und Konfigurationsabgleich sind reversible, protokollierte Aktionen – manuell oder regelbasiert mit Cooldown.
Incidents
Korreliert Warnungen, Verantwortliche, Kommentare und Maßnahmen; berechnet MTTD/MTTR und exportiert einen technischen Bericht.
Zeitpläne
Einmalige oder wöchentliche sichere Aktionen mit fester Zeitzone.
Wartungsfenster
Unterdrücken erwartbare Warnungen für Organisation, Gruppe oder Gerät, ohne echte Daten zu löschen.
Gestufte Rollouts
Starten klein, beobachten angewandte Revision und Health, promoten kontrolliert oder rollen zur vorherigen Konfiguration zurück.
Noch nicht produktiv freigeschaltet: externe Alert-Webhooks, unabhängiges Verfügbarkeitsmonitoring, Push über APNs/FCM und Stripe-Live-Checkout bleiben bis zur finalen Konfiguration verborgen.
Local-first
Sicherheit & Datenschutz.
Inhalte bleiben lokal
Webseiteninhalte, Formulareingaben und Browserverlauf werden nicht an die Control Plane übertragen.
Minimierte Telemetrie
Bei Fleet: Geräte-ID, Plattform, Version, Heartbeat, Revision und technische Diagnosezähler.
Portal-Sitzung
Backend-Token bleibt serverseitig. Der Browser erhält ein Secure-, HttpOnly- und SameSite-Strict-Cookie.
MFA & Recovery
TOTP-Secret verschlüsselt; zehn einmalige Recovery-Codes nur bei Aktivierung sichtbar; Sitzungen einzeln widerrufbar.
Konfigurations-Export
Enthält keine PIN, API-Tokens, MQTT-, Basic-Auth- oder sonstigen Passwörter.
Support-Sitzung
Standardmäßig aus, sichtbar bestätigt, zeitlich begrenzt und auditierbar.
Diagnose
Fehler systematisch beheben.
Seite lädt nicht
- Netzwerk und URL testen
- Allowlist prüfen
- DNS/TLS kontrollieren
- Reload und Home
- WebView neu starten
Gerät offline
- Lokalen Kioskstatus prüfen
- Internet und Systemzeit prüfen
- Pairingstatus kontrollieren
- App-/OS-Energiesparen prüfen
- Bei Bedarf neu koppeln
Lizenz fehlt
- Richtiges Store-Konto prüfen
- Käufe wiederherstellen
- Portalzuordnung prüfen
- Vollständige Synchronisierung
- Support mit App-Version kontaktieren
Portal-Login
- E-Mail prüfen
- Passwort-Reset verwenden
- Cookies zulassen
- Nach Passwortwechsel neu anmelden
- Rate-Limit abwarten
Für eine Support-Anfrage hilfreich: Plattform, Gerätemodell, Betriebssystem, KioskPilot-Version, ungefährer Zeitpunkt und genaue Fehlermeldung. Niemals Passwort, API-Token, Recovery-Code oder vollständige Rechnungsdaten senden.
Antwort nicht gefunden?
Die FAQ beantwortet kurze Einzelfragen. Bei einem konkreten Fehler helfen Plattform, App-Version und eine genaue Beschreibung bei der schnellen Eingrenzung.
Fundamentals
How KioskPilot is structured.
KioskPilot deliberately separates local kiosk operation from accounts and cloud services. A device can start without an account. A portal account organizes people, devices, and billing; it is not itself a device license.
Free
A permanent web kiosk with no ads or time limit. The visible Free watermark remains active.
Pro – per device
Removes the watermark and enables professional local features for exactly one device or bound installation.
Fleet Cloud
A separate offering for central management, teams, groups, health, rollouts, and support. It does not replace a Pro device license.
Customer portal
Manages users, devices, available and assigned license seats, billing addresses, and documents.
Remember: Users manage devices. Licenses apply per device. Fleet manages the fleet.
Three steps
Initial setup.
To start locally, you only need a target page, a sensible security boundary, and an admin PIN.
- Set the home page. Use HTTPS or a private LAN HTTP address. Public HTTP targets are rejected.
- Allow domains. Include the home-page host and add others only when required for navigation.
- Choose PIN and behavior. Set admin PIN, keep-awake, reload, orientation, and optional display schedules. Test, then start the kiosk.
Home URL
The fixed page used by Home, Autopilot, and offline recovery.
Domain allowlist
Checks main navigation, pop-ups, scanner, NFC, and launcher web targets.
Admin PIN
Protects local settings. Never display it near a publicly accessible device.
Connection test
Finds DNS, network, certificate, and allowlist issues before kiosk start.
Web content
Browser & navigation.
The kiosk browser is not a general-purpose browser: it displays your configured application and limits unexpected exits.
User agent & zoom
Choose mobile, desktop, or custom profiles plus page and text zoom. Use a custom user agent only when required.
Pop-ups
Only after a user gesture and for allowed hosts. Valid targets are redirected into the checked main window.
File uploads
Use the system file picker and can be disabled by policy.
Web permissions
Camera, microphone, and location are separate, off by default, and limited to allowed hosts.
Cookies & mixed content
Third-party cookies and LAN mixed content are separate compatibility options, disabled by default.
Basic Auth
The password is encrypted in Android Keystore or Apple Keychain and omitted from exports.
Never bypassed: TLS certificate failures and Safe Browsing or fraud warnings.
Device & screen
Display, screen saver & launcher.
Keep awake & orientation
Keeps the display active and selects portrait, landscape, or system orientation where supported.
Brightness & night plan
Defines day/night brightness and times. The OS may enforce hard minimums.
Pixel Shift
Moves static content minimally and reversibly to distribute long-term load.
Screen saver
Black, clock, or message after inactivity. A touch returns to the kiosk.
Universal Launcher
Shows approved websites and apps as tiles. Web targets remain allowlist-bound.
Scanner & NFC
QR, barcode, and NDEF targets are read, validated, then opened. Formats vary by device.
KioskPilot Intelligence
Autopilot, Offline Rescue & protection.
Kiosk Autopilot
Monitors loading, network, and renderer. Escalation: reload, home, rebuild web view, Offline Rescue, and technical Fleet diagnostics.
Offline Rescue
A local fallback with a clear message and controlled return when the home page recovers.
Privacy mode
Clears cookies, web storage, forms, and history after inactivity and starts a fresh session.
Accessibility Check
Locally checks touch targets, labels, overflow, scaling, and basic contrast/font indicators.
Display protection
Combines pixel shift, brightness plans, and technical thermal/battery signals where available.
Temporary support
Single-use short-lived code, visible consent, limited rights, automatic end, and audit entry.
Data-minimized: Accessibility and Autopilot run locally. Fleet receives technical state and counters, never DOM content or form entries.
Smart home
Home Assistant & integrations.
KioskPilot can discover a local Home Assistant dashboard and integrate it professionally.
- Start Quick Setup. KioskPilot searches for `_home-assistant._tcp.local.` on the LAN.
- Select an instance. The internal address becomes the home page and its host is allowed.
- Optionally integrate Pro. Enable local API or TLS MQTT and publish Home Assistant Discovery.
Local API · Pro
Private networks, random bearer token. Read status and trigger reload, home, privacy reset, launcher, or brightness.
TLS MQTT · Pro
Only `ssl://`/`mqtts://`. Publishes minimized state and accepts defined commands. Passwords are never exported.
Discovery
Can register online sensors and actions such as Reload or Home in Home Assistant.
LAN security
The HTTP LAN API uses a token but not encryption. Use TLS MQTT or Fleet on untrusted networks.
Licensing
Free, Pro & license status.
Pro applies to the activated device or cryptographically bound installation. The portal shows available and assigned seats; a user account never becomes a multi-device license.
Free
- Local web kiosk
- Basic Autopilot
- Offline Rescue
- Quick Setup and Accessibility Check
- Visible watermark
Pro
- No watermark
- Advanced Autopilot/privacy
- Local API and TLS MQTT
- Device Owner/managed policies
- One license per device
Restore purchases
Asks the store again for active purchases and restores the local entitlement.
Full synchronization
Clears inconsistent local license caches and rebuilds state from store and control plane. The purchase is not deleted.
Store boundary: Portal seats and store purchases are separate. Reassigning a portal seat does not automatically move a store purchase.
Platforms
Android and iOS/iPadOS.
Android · regular install
Immersive full screen and screen pinning with OS limits.
Android · Device Owner
Dedicated Device with Lock Task, enterprise policies, and more reliable startup. Requires proper provisioning.
iPhone/iPad · personal
Guided Access is the practical single-app option. A regular app cannot fully lock the device or auto-start.
iPhone/iPad · supervised
Apple Configurator or MDM can provide Single App Mode and managed configuration.
Feature parity means equivalent product effect: Android uses Device Owner; Apple uses Guided Access or MDM. OS security mechanisms are never bypassed.
Central management
Fleet Cockpit & customer portal.
- Organization and users. Owner, Admin, Operator, and Read-only have clearly bounded rights.
- Pair a device. Create a short-lived code in the portal and visibly confirm it in the app.
- Assign a license. Assign one available Pro seat to exactly one owned device.
- Organize operations. Name, group, monitor, and safely roll out configuration revisions.
Overview
Device count, online state, alerts, license use, and key actions.
Devices
Pairing, home URL, allowlist, technical details, revision, support code, and revoke.
Licenses
Total, assigned, and available. Every assignment remains device-bound.
Billing
Versioned billing addresses, immutable direct invoices, and separate store receipts.
Team
Invitations are single-use and valid for 48 hours. Members choose their own passwords.
Account
Password, TOTP MFA, recovery codes, active sessions, and sign-out.
Safe operations
Health, incidents & rollouts.
Fleet Health
Evaluates heartbeat, errors, and technical signals against configurable thresholds.
Device actions
Reload, Home, and config sync are reversible, audited actions with optional cooldown.
Incidents
Correlates alerts, owners, comments, and actions; calculates MTTD/MTTR and exports reports.
Schedules
One-time or weekly safe actions in a fixed time zone.
Maintenance windows
Suppress expected alerts for organization, group, or device without deleting data.
Staged rollouts
Start small, observe revision and health, promote safely, or roll back.
Not yet production-enabled: external alert webhooks, independent availability monitoring, APNs/FCM push, and Stripe live checkout remain hidden until final configuration.
Local-first
Security & privacy.
Content stays local
Website content, form entries, and browsing history are not sent to the control plane.
Minimized telemetry
Fleet receives device ID, platform, version, heartbeat, revision, and technical counters.
Portal session
The backend token stays server-side; the browser gets a Secure, HttpOnly, SameSite-Strict cookie.
MFA & recovery
Encrypted TOTP secret, ten one-time recovery codes, and revocable sessions.
Configuration export
Never includes PIN, API token, MQTT, Basic Auth, or other passwords.
Support session
Off by default, visibly approved, time-limited, and audited.
Diagnostics
Troubleshoot systematically.
Page will not load
- Test network and URL
- Check allowlist
- Check DNS/TLS
- Reload and Home
- Restart web view
Device offline
- Check local kiosk
- Check internet and time
- Check pairing
- Check OS power saving
- Pair again if needed
License missing
- Check store account
- Restore purchases
- Check portal assignment
- Run full sync
- Contact support with app version
Portal sign-in
- Check email
- Use password reset
- Allow cookies
- Sign in after password change
- Wait for rate limit
Useful for support: platform, device model, OS, KioskPilot version, approximate time, and exact error. Never send passwords, API tokens, recovery codes, or complete billing data.
Could not find the answer?
The FAQ covers short questions. For a specific issue, platform, app version, and an exact description help us narrow it down quickly.