Anleitung

In 15 Minuten zum ersten Bild

OpenSourceSignage läuft auf gewöhnlichem Webspace. Es gibt keinen Build-Schritt, keinen Paketmanager und keinen Container – was im Archiv liegt, läuft nach dem Entpacken.

Voraussetzungen

Technische Voraussetzungen für den Betrieb
Webserver	Apache mit `mod_rewrite` (nginx geht ebenfalls)
PHP	8.1 oder neuer, mit `pdo_mysql`, `mbstring`, `openssl`
Datenbank	MySQL 5.7+ oder MariaDB 10.3+
Speicher	ab 200 MB – je nach Mediathek deutlich mehr
Freiwillig	`ffmpeg` für Videos, `poppler-utils` für PDF-Import, GD für Vorschaubilder

Kein Root-Zugang nötig, kein SSH, keine Kommandozeile. Was fehlt, sagt der Assistent vor der Installation – und später noch einmal die Betriebsprüfung in den Einstellungen.

Schritt für Schritt

Dateien hochladen

Archiv entpacken und den Inhalt auf den Webspace legen. Wichtig ist nur eines: Der DocumentRoot zeigt auf manager/public. Konfiguration, Quellcode und Vorlagen liegen bewusst darüber und sind so aus dem Netz nicht erreichbar.

Datenbank anlegen

Eine leere Datenbank samt Benutzer im Verwaltungsbereich Ihres Anbieters anlegen. Name, Benutzer und Kennwort bereithalten – mehr wird nicht gebraucht.

Assistenten durchlaufen

Die Adresse im Browser öffnen. Der Assistent prüft die Voraussetzungen, legt das Datenbankschema an, schreibt die Konfiguration und richtet das erste Konto ein. Auf Wunsch mit Beispielinhalten, damit sofort etwas zu sehen ist.

Wer lieber auf der Kommandozeile arbeitet, nimmt stattdessen:

php installer/cli.php --db-name=signage --db-user=… --db-pass=… \
    --admin-name="Vorname Name" --admin-email=… --admin-password=…

Erstes Display koppeln

In der Verwaltung ein Display anlegen – es bekommt einen Kopplungscode. Diesen im Player eingeben, zusammen mit der Adresse der Installation. Danach meldet sich das Gerät von selbst und holt sich, was es zeigen soll.

Zeitsteuerung einrichten

Ein Aufruf alle fünf Minuten hält alles Regelmäßige am Laufen: Datenquellen holen, Videos herrichten, Sicherungen anlegen, Papierkorb leeren, Ausfälle erkennen.

*/5 * * * * php /pfad/zur/installation/tools/tick.php

Ohne SSH geht es auch über eine Adresse, die die Zeitsteuerung Ihres Anbieters aufruft. Den fertigen Eintrag zeigt die Verwaltung unter Einstellungen → Zeitsteuerung.

Player einrichten

Android

APK auf das Gerät bringen und installieren. Beim ersten Start Serveradresse und Kopplungscode eintragen. Der Player startet danach mit dem Gerät und hält den Bildschirm wach.

Windows

Eine einzelne EXE, kein Installer. Beim ersten Start Serveradresse eintragen, Monitor und Vollbild wählen. Autostart lässt sich im selben Dialog setzen.

Browser

Die Adresse /player/ der Installation aufrufen und den Kopplungscode eingeben. Praktisch für Smart-TVs und für einen schnellen Versuch ohne Installation.

Aktualisieren

Aktualisierungen laufen über die Verwaltung – ohne SSH auf dem Zielserver. Das Programm holt die neue Fassung, legt vorher jede Datei beiseite, kopiert sie über die Installation, spielt die Datenbankänderungen ein und schaltet den Wartungsmodus danach wieder ab.

Geht dabei etwas schief, wird der vorherige Stand zurückgeschrieben. Ein Mischzustand darf eine Installation ohne SSH nicht verlassen. Die eigene Konfiguration, die Mediathek und hochgeladene Schriften bleiben unberührt.

Auf der Kommandozeile geht es ebenfalls:

php tools/update.php --pruefen    # Voraussetzungen prüfen
php tools/update.php --check      # beim Update-Dienst nachfragen
php tools/update.php --install    # einspielen
php tools/update.php --zurueck    # auf den vorherigen Stand zurück

Fragen offen?

Die häufigsten Fragen sind auf der Startseite beantwortet – von Voraussetzungen bis zum Verhalten ohne Netz.

Zu den häufigen Fragen