Einrichtungsanleitung
Der gesamte Vorgang von Anfang bis Ende. Plane etwa 20 Minuten ein, die meiste Zeit wartest du auf Downloads.
Lade Raspberry Pi Imager herunter und öffne es – das offizielle, kostenlose Werkzeug von Raspberry Pi selbst. Stecke deine SD-Karte ein und gehe dann im Imager so vor:
Betriebssystem wählen → Raspberry Pi OS (64-Bit). Speicher wählen → deine SD-Karte.
Bevor du auf „Weiter“ klickst, klicke auf das Zahnrad-/Einstellungs-Symbol (oder du wirst dazu aufgefordert), um einiges vorab einzustellen – lege einen Hostnamen fest, aktiviere SSH und gib hier deine WLAN-Daten ein. Wenn du das jetzt tust, verbindet sich der Pi beim ersten Start automatisch mit deinem Netzwerk, ganz ohne dass Tastatur oder Maus angeschlossen sein müssen.
Klicke auf „Schreiben“ und warte, bis es fertig ist (das ist der langsame Teil).
Stecke die SD-Karte in den Pi, schließe ihn an deinen Bildschirm an und schalte ihn ein. Gib ihm ein paar Minuten für den ersten Start – im Hintergrund erledigt er einige einmalige Einrichtungsschritte.
Sitzt du direkt am Pi, öffne ein Terminalfenster. Verbindest du dich stattdessen von einem anderen Computer aus, öffne dein eigenes Terminal und verbinde dich zuerst per SSH (ersetze den Namen durch den Hostnamen, den du in Schritt 1 festgelegt hast):
Starte dann den Installer:
Das lädt die neueste Version herunter und richtet alles automatisch ein – Node.js, die App selbst und den Kioskmodus für den Wandbildschirm. Zwischendurch fragt es nach deinem Passwort (für ein paar einmalige Systeminstallationen) und startet am Ende automatisch neu.
Nach dem Neustart sollte die Kalenderanzeige automatisch auf dem angeschlossenen Bildschirm erscheinen. Rufe vom Handy oder einem beliebigen Browser im selben Netzwerk die auf diesem Bildschirm angezeigte Adresse auf, um die Einrichtung abzuschließen – du wählst, ob dies dein Hauptgerät ist, und gibst (beim Hauptgerät) eine E-Mail-Adresse zum Aktivieren ein. Wenn du Home Assistant nutzt, fragt die Einrichtung auch, ob du es verbinden möchtest – optional, und später in den Einstellungen genauso leicht nachzuholen, falls du es jetzt überspringen willst. Keine Zahlung nötig – über die E-Mail-Adresse bekommst du nur Update-Hinweise.
Danach geht es weiter mit Designs, Kalenderquellen und allen in deiner Familie oder deinem Team.
Eine Abkürzung, die man kennen sollte: Strg+Alt+K schaltet die Kioskanzeige ein oder aus, falls du einmal an ein Terminal auf dem Pi selbst kommen musst.
Das hängt davon ab, wo. Wenn ~/piazzahq noch nicht existiert, kannst du den einzeiligen Installationsbefehl gefahrlos noch einmal von vorn ausführen. Existiert der Ordner bereits (auch durch einen teilweise fehlgeschlagenen Versuch), führe die Einzeile nicht erneut aus – sie verweigert das absichtlich, damit nichts gelöscht wird. Führe stattdessen bash ~/piazzahq/install.sh direkt aus; das lässt sich bedenkenlos beliebig oft wiederholen und überspringt Schritte, die bereits geklappt haben. Bleibt es immer an derselben Stelle hängen, notiere dir die genaue Fehlermeldung und melde dich bei uns.
Gib ihm noch eine Minute – die Kioskanzeige braucht nach dem Start manchmal einen Moment. Ist er danach immer noch schwarz, prüfe, ob das HDMI-Kabel im Anschluss mit der Beschriftung HDMI0 bei einem Pi 4/5 steckt und nicht im zweiten Anschluss.
Sie wird direkt auf dem Wandbildschirm selbst angezeigt, sobald er läuft. Wenn du in Schritt 1 einen eigenen Hostnamen festgelegt hast, probiere http://<dieser-hostname>.local von einem Handy im selben WLAN aus.
Ja – jedes Gerät mit einem Webbrowser kann ein Bildschirm sein: ein altes Tablet, der eingebaute Browser eines Fire Stick oder Chromecast, ein übriger Monitor an einer günstigen Streaming-Box. Gehe in der App zu Geräte → „Bildschirm hinzufügen“, wähle, welches Layout er zeigen soll, und scanne entweder den QR-Code auf dem neuen Gerät oder tippe die angezeigte Adresse ein. Beim ersten Laden erscheint er in deiner Bildschirmliste.
Ist das neue Gerät im selben WLAN wie dein Pi, funktioniert das sofort. Für etwas, das zwischen Netzwerken wechselt – etwa ein Tablet, das du von Raum zu Raum trägst – installiere zuerst Tailscale auf dem Pi und auf dem neuen Gerät; die App erkennt es automatisch und gibt dir einen Link, der von überall in deinem Tailnet funktioniert und nicht nur im aktuellen WLAN.
Home Assistant ist ein eigenständiges, kostenloses Projekt – es gehört nicht zu Piazza HQ, und die Einrichtung hier kümmert sich nur darum, eine bestehende Installation zu verbinden , die bei dir bereits läuft. Wenn du bei null anfängst, ist die einfachste Variante ohne eigenen Aufwand Home Assistant Green – eine kleine Box, die schon mit installiertem System kommt; du musst nur Strom und Netzwerk anschließen.
Möchtest du es lieber selbst auf Hardware betreiben, die du ohnehin hast (ein übriger Pi oder derselbe Rechner wie dein Piazza-HQ-Zentralserver), ist das hier der offizielle Docker-Installationsbefehl – er funktioniert auf einem Raspberry Pi oder jedem Linux-Rechner, auf dem Docker Engine bereits installiert ist (setze zuerst deine eigene Zeitzone und einen Ordner für die Konfiguration ein):
Sobald es läuft, rufe http://<Adresse dieses Rechners>:8123 auf, um seine eigene Einrichtung abzuschließen – komm dann hierher zurück (Einstellungen → Home Assistant oder der Einrichtungsassistent bei einer frischen Installation), um es zu verbinden.
Dieser Docker-Weg enthält nicht die optionalen „Apps“ von Home Assistant (Zigbee2MQTT, einen MQTT-Broker usw.) – das reicht, um Sensoren und Schalter mit Piazza HQ zu verbinden, aber wenn du diese vermutlich haben möchtest, bekommst du sie mit dem Beschreiben des vollständigen Home Assistant OS ebenfalls. Der Installationsprozess von Home Assistant kann sich im Lauf der Zeit ändern – deren offizielle Installationsdokumentation ist maßgeblich, falls hier etwas veraltet aussieht.
Die Einrichtung fragt beim ersten Start danach – füge einfach deine Home-Assistant-URL (z. B. http://homeassistant.local:8123) und ein langlebiges Zugriffstoken ein (in Home Assistant: dein Profil → Reiter „Sicherheit“ → Langlebige Zugriffstoken → Token erstellen). Übersprungen oder richtest du einen zweiten Bildschirm ein? Das geht jederzeit unter Einstellungen → Home Assistant. In beiden Fällen bleiben URL und Token auf deinem eigenen Server – sie werden nie an den Bildschirm oder an jemandes Handy gesendet. Nach dem Verbinden kannst du im Layout ein Entitätsstatus-Widget hinzufügen, um den aktuellen Zustand eines beliebigen Sensors oder Geräts anzuzeigen, Lichter und Schalter umzuschalten, einen Thermostat einzustellen oder eine Szene auszuführen.
Du möchtest es auch in die andere Richtung – Home Assistant schaltet einen Bildschirm ein/aus oder wechselt das Layout einer Anzeige? Das ist eine eigene Einrichtung unter Einstellungen → Home-Assistant-Steuerung: siehe die vollständige Anleitung für die drei Möglichkeiten, es zu verbinden.
PiazzaHQ-Setup.exe herunterladen und führe die Datei aus. Keine Administratorrechte nötig – sie installiert sich in deinen eigenen Benutzerordner (%LocalAppData%\PiazzaHQ), nicht nach „Programme“, daher gibt es keine UAC-Abfrage.
Node.js ist enthalten – nichts anderes muss separat installiert werden.
Ein Kontrollkästchen auf der Seite „Zusätzliche Aufgaben auswählen“ des Assistenten:
Nicht angehakt (Standard) – Steuergerät. Eine normale Desktop-Verknüpfung öffnet die App im Fenster, in deinem gewohnten Browser. Gut für den PC, den du im Alltag selbst benutzt.
Angehakt – Wandbildschirm. Jede Verknüpfung öffnet den Kalender im Vollbild ohne Browser-Rahmen, und er wird in den Autostart aufgenommen, sodass er bei deiner nächsten Anmeldung automatisch startet. Nutze das auf einem PC, der ausschließlich als Anzeige dient.
Hake am Ende der Einrichtung „Jetzt starten“ an oder doppelklicke einfach auf die neue Desktop-Verknüpfung. Beim ersten Start fragt die Windows-Firewall, ob die App in deinem Netzwerk zugelassen werden soll – bestätige das; das ist bei allem normal, was einen Port zum Zuhören öffnet, und hat nichts mit dem Signieren zu tun.
Wandbildschirm-Modus: Gib ihm ein paar Sekunden, dann füllt er den Bildschirm. Um den Vollbildmodus zu verlassen, tippe oder klicke einmal irgendwo darauf – für ein paar Sekunden erscheint in der Ecke eine kleine Schaltfläche ⤢ Vollbild beenden (Alt+F4 funktioniert ebenfalls immer).
Ab hier wie überall sonst: Rufe vom Handy oder einem beliebigen Browser im selben Netzwerk die auf der Anzeige gezeigte Adresse auf, um die Einrichtung abzuschließen – wähle, ob dies dein Hauptgerät ist, und gib eine E-Mail-Adresse zum Aktivieren ein. Designs, Kalenderquellen, alle in deiner Familie oder deinem Team – alles genauso wie beim Pi.
Auch Updates laufen genauso: Die App prüft selbst und aktualisiert sich automatisch. Den Installer musst du nur erneut ausführen, wenn etwas den Installer selbst betrifft (selten – wir sagen es immer ausdrücklich, wenn eine Version das braucht).
Klicke auf der blauen Warnseite auf Weitere Informationen, dann auf Trotzdem ausführen. Dieser Build ist vorerst absichtlich unsigniert – die Warnung ist erwartbar und kein Zeichen dafür, dass mit der Datei etwas nicht stimmt.
Tippe oder klicke irgendwo auf den Bildschirm – in der Ecke erscheint eine kleine Schaltfläche ⤢ Vollbild beenden. Alt+F4 funktioniert ebenfalls immer. (Die Schaltfläche zum Einblenden per Tippen benötigt einen Installer aus dem aktuellen Stand dieser Anleitung; bei einer viel älteren Installation gibt es womöglich nur Alt+F4, bis du neu installierst.)
Ja – wie beim Pi: Jedes Gerät mit einem Browser kann ein Bildschirm sein. Gehe in der App zu Geräte → „Bildschirm hinzufügen“, wähle ein Layout und scanne den QR-Code oder tippe vom neuen Gerät aus die angezeigte Adresse ein.
Laufen auf diesem Rechner schon andere selbst gehostete Apps (Plex, Home Assistant, der App-Store eines NAS)? Dann hast du es mit ziemlicher Sicherheit. Falls nicht, ist die offizielle Installation unter Linux eine einzige Zeile:
Unter Mac oder Windows installiere stattdessen Docker Desktop .
Lege dafür einen Ordner an und darin eine Datei mit dem Namen docker-compose.yml und diesem Inhalt:
Setze deine eigene Zeitzone ein. Das ist die ganze Konfiguration – deine Daten liegen im benannten Volume, sicher getrennt vom Container selbst.
Das war's – kein separates Installationsskript, keine Betriebssystempakete außer Docker selbst.
Rufe http://<Adresse dieses Rechners>:3000/app vom Handy oder einem beliebigen Browser im selben Netzwerk auf, um die Einrichtung abzuschließen – wähle, ob dies dein Hauptgerät ist, und gib eine E-Mail-Adresse zum Aktivieren ein. Alles Weitere (Designs, Kalenderquellen, alle in deiner Familie oder deinem Team) funktioniert genau wie beim Pi – du verwaltest es nur vollständig im Browser statt an einem physischen Bildschirm.
Updates laufen hier absichtlich anders: Der Updater in der App ist in einem Container abgeschaltet (es gibt nichts, wohin er schreiben könnte). Stattdessen:
Bridge-Netzwerk (der Standard in der Compose-Datei oben) reicht für Kalenderfeeds, Wetter und Updates, kann aber keine LAN-Geräte finden und keine .local-Hostnamen auflösen. Entferne den ports:-Block und füge stattdessen network_mode: host hinzu – dann läuft die App direkt im eigenen Netzwerk des Hosts.
Im benannten Docker-Volume piazzahq-data, nicht im Container selbst – ein neues Image zu laden und den Container neu zu erstellen berührt es nie. Den echten Pfad auf der Festplatte findest du mit docker volume inspect piazzahq-data, wenn du es direkt sichern möchtest – oder nutze in der App Einstellungen → Sicherungen → „Vollständige Sicherung herunterladen“.
Ja – wie überall sonst: Jedes Gerät mit einem Browser kann ein Bildschirm sein. Gehe in der App zu Geräte → „Bildschirm hinzufügen“, wähle ein Layout und scanne den QR-Code oder tippe vom neuen Gerät aus die angezeigte Adresse ein.
Ja – Proxmox selbst ist kein Docker-Host, daher läuft es in einer VM oder einem LXC-Container auf deinem Proxmox-Server, aber ab da ist die Einrichtung genau dieselbe. Am einfachsten: eine kleine Debian- oder Ubuntu-VM (1 vCPU, ca. 1 GB RAM reichen völlig) mit normal installiertem Docker, dann dieser Anleitung unverändert folgen. Lieber einen LXC-Container? Aktiviere unter den Optionen → Funktionen dieses Containers zuerst Nesting und Keyctl – Docker braucht sie, um seine eigenen verschachtelten Namensräume anzulegen – und installiere Docker dann darin auf dieselbe Weise.
Fernzugriff einrichten, manuell auf X11 umschalten, Protokolle prüfen – siehe die Seite zur Fehlerbehebung mit Befehlen zum Kopieren (vorerst Pi-spezifisch).
Du möchtest erkunden, was die App wirklich kann? Das Benutzerhandbuch behandelt jeden Reiter.