Image für Raspberry Pi 4 / 5 (64 Bit)

Alles vorinstalliert – auf die SD-Karte schreiben, Server-Adresse eintragen, fertig.

Kiosk-Box einrichten

Diese Anleitung macht aus einem Raspberry Pi mit Touch-Display und Etikettendrucker eine Kiosk-Box für LogonApp. Mit dem fertigen Image dauert das etwa 10 Minuten. Image und Software sind kostenlos, die Kopplung an Ihr Konto ist eine monatliche Zusatzleistung (ab Tarif Business).

Sie möchten nichts selbst einrichten? Das Komplett-Set wird fertig konfiguriert geliefert: Einstecken, Code eingeben, fertig.

Was Sie brauchen

Teil	Empfehlung
Rechner	Raspberry Pi 5 (4 GB) oder Pi 4 (2 GB), offizielles Netzteil, Kühlkörper
Display	Touch-Display 7 bis 10 Zoll (z. B. Raspberry Pi Touch Display 2), alternativ jeder HDMI-Touchscreen
Speicher	Industrie- oder High-Endurance-SD-Karte ab 16 GB
Drucker	Freigegeben: Brother QL-800 (empfohlen), QL-820NWB, QL-1110NWB, Dymo LabelWriter 450 und 450 Duo – jeweils per USB
Etiketten	Brother DK-22205 (62 mm endlos) oder Dymo 99014 (54 × 101 mm)
Netzwerk	LAN-Kabel (empfohlen) oder WLAN mit Internetzugang. Es werden nur ausgehende Verbindungen benötigt.

Andere Drucker (z. B. Dymo LabelWriter 550, Netzwerkdruck) werden derzeit nicht unterstützt.

1. Image auf die SD-Karte schreiben

Das Image logonapp-kiosk-arm64.img.xz herunterladen (Schaltfläche unten oder auf der Release-Seite).
Den Raspberry Pi Imager öffnen, bei *Betriebssystem* ganz unten Eigenes Image wählen und die heruntergeladene Datei angeben. Die Frage nach Anpassungen mit Nein beantworten.
Karte schreiben.

Im Image ist alles vorinstalliert: Agent, Kiosk-Anzeige, Brother-Druckwerkzeug, CUPS mit Dymo-Treiber, nächtlicher Neustart, Watchdog und automatische Sicherheitsupdates.

2. Einstellungen eintragen

Die SD-Karte nach dem Schreiben noch einmal in den PC stecken. Auf dem Laufwerk bootfs liegt die Datei logonapp.txt. Mit einem beliebigen Editor öffnen:

SERVER_URL=https://ihre-logonapp.de
WIFI_SSID=
WIFI_PASSWORD=
WIFI_COUNTRY=DE
SERVICE_PIN=
ROTATE=0
REBOOT_AT=04:00
AUTO_UPDATE=1

Eintrag	Bedeutung
`SERVER_URL`	Adresse Ihres LogonApp-Servers. Pflicht, falls nicht schon vorbelegt.
`WIFI_SSID`, `WIFI_PASSWORD`	Nur für WLAN. Das Passwort wird nach dem ersten Start aus der Datei gelöscht.
`SERVICE_PIN`	Optional: feste PIN (4–8 Ziffern) für das Service-Menü vor der Kopplung
`ROTATE`	Bildschirm drehen: `0`, `90`, `180` oder `270`
`REBOOT_AT`	Uhrzeit des nächtlichen Neustarts
`AUTO_UPDATE`	`1` = Agent aktualisiert sich nachts selbst, `0` = aus

Die Datei wird bei jedem Start gelesen. Änderungen später einfach wieder am PC eintragen.

3. Drucker anschließen und einschalten

Drucker per USB anschließen, SD-Karte in den Pi, Display und Netzwerk anschließen und einschalten.

Brother QL: druckt ohne Treiber direkt per USB. Den Editor-Lite-Modus des Druckers ausschalten (grüne LED aus).
Dymo LabelWriter 450 / 450 Duo: die Box legt die Druckwarteschlange beim ersten Druck selbst an. Nichts einzurichten.

4. Box koppeln

Nach dem Start zeigt das Display einen sechsstelligen Code.
Im Portal unter Einstellungen → Kiosk-Boxen den Code eingeben, Standort und Druckermodell wählen.
Nach wenigen Sekunden erscheint der Kiosk. Mit Testdruck prüfen, ob Rand und QR-Code vollständig sind.
Eine Service-PIN vergeben. Damit öffnet man an der Box das Service-Menü.

Service vor Ort

Service-Menü: fünfmal in die linke obere Ecke des Displays tippen, Service-PIN eingeben. Dort: Zustand, Testdruck, Kiosk neu laden, neu koppeln.
Im Netzwerk: http://<IP-der-Box>:8080/service (die IP steht im Portal bei der Box).
Vor der Kopplung zeigt das Display eine einmalige Service-PIN (oder die in logonapp.txt eingetragene). Nach der Kopplung gilt nur noch die im Portal vergebene PIN.
Die Box hat bewusst keinen Login und kein SSH. Für Wartung die SD-Karte am PC bearbeiten oder neu beschreiben – die Kopplung muss danach erneut erfolgen.

Fehlerbehebung

Problem	Lösung
Display zeigt „Einrichtung nötig“	`SERVER_URL` in `logonapp.txt` fehlt oder ist ungültig (muss mit `https://` beginnen).
Display zeigt „Verbinde mit dem Server …“	Netzwerkkabel bzw. WLAN-Daten prüfen. Bei WLAN: Passwort erneut eintragen und neu starten.
Code wird im Portal nicht angenommen	Der Code gilt 30 Minuten, danach zeigt die Box automatisch einen neuen. Prüfen, ob noch eine Box-Kopplung gebucht ist.
„Drucker prüfen“ unten rechts	Drucker eingeschaltet und per USB verbunden? Im Portal das richtige Druckermodell gewählt? Bei Brother: Editor-Lite aus. Im Service-Menü steht die genaue Meldung.
Ausweis zu klein oder abgeschnitten	Im Portal das passende Etikett wählen.
Box soll an einen anderen Standort	Im Portal bei der Box den Standort ändern, kein Neukoppeln nötig.
Box verloren oder ausgetauscht	Im Portal Entfernen: Die Box verliert sofort jeden Zugang.

Alternative: vorhandenes Raspberry Pi OS

Wer ein eigenes Raspberry Pi OS (64 Bit) weiterverwenden möchte, kann den Agenten als Docker-Container einrichten:

curl -fsSL https://raw.githubusercontent.com/SBajonczak/LogonApp/main/agent/pi/setup.sh | sudo SERVER_URL=https://ihre-logonapp.de bash

Datenschutz

Die Box speichert keine Besucherdaten. Ausweise werden als PDF verschlüsselt übertragen, nach dem Druck sofort gelöscht (auf der Box und auf dem Server) und spätestens nach einer Stunde verworfen, falls sie nie abgeholt wurden. Protokolle liegen nur im Arbeitsspeicher. Die Box baut nur ausgehende Verbindungen zum LogonApp-Server und für Updates zu GitHub auf.

Lieber fertig geliefert?

Das Komplett-Set kommt vorkonfiguriert und ist in fünf Minuten am Empfang.

Set anfragen