Zum Hauptinhalt springen
Schneespur
Dokumentation durchblättern

Betrieb & Self-Hosting

Systemvoraussetzungen

Was ein Webhosting mitbringen muss, damit Schneespur darauf läuft: PHP-Version, Datenbank, PHP-Erweiterungen, Cron-Unterstützung — und was ausdrücklich nicht nötig ist.

Schneespur ist dafür gebaut, auf gewöhnlichem Webhosting zu laufen — auf demselben Hosting, das ein Betrieb ohnehin für seine Firmenwebsite nutzt. Diese Seite nennt die technischen Voraussetzungen, damit Sie vor der Installation prüfen können, ob Ihr Hosting genügt.

Mindest-Voraussetzungen

AnforderungWert
PHP8.4 oder höher (genau: 8.4.1)
DatenbankMySQL 5.7+ oder MariaDB 10.3+
PHP-Erweiterungenpdo_mysql und gd
HintergrundaufgabenUnterstützung für Cron-Jobs
DateizugriffFTP-Zugang oder ein Dateimanager

Die meisten Shared-Hosting-Anbieter erfüllen das standardmäßig. Anbieter wie Strato, IONOS oder All-Inkl bringen die nötige PHP- und Datenbank-Ausstattung für wenige Euro im Monat mit; PHP 8.4 gehört dort zum Standardangebot.

Die Erweiterung gd wird für die Bildverarbeitung der Einsatz-Fotos gebraucht, pdo_mysql für den Datenbankzugriff. Beide sind auf typischem PHP-Hosting bereits aktiv.

Wenn nach der Installation eine leere Seite erscheint

Ein Webspace kann PHP 8.4 anbieten und trotzdem auf einer älteren Version eingestellt sein — etwa, weil er schon länger für eine andere Anwendung läuft. Der Fall ist deshalb erwähnenswert, weil er unangenehm aussieht: Die Versionsprüfung läuft, bevor die Anwendung selbst startet, deshalb kommt keine erklärende Meldung, sondern eine leere Fehlerseite. Auch der Einrichtungsassistent kann das Problem dann nicht mehr benennen.

Wer also eine leere Seite sieht, sieht als Erstes die eingestellte PHP-Version im Kunden-Center nach und stellt sie auf 8.4 oder neuer.

Ältere Fassungen dieser Dokumentation nannten PHP 8.2. Das war falsch: Seit Version 1.1.7 verlangen die mitgelieferten Bibliotheken 8.4.1, ohne dass es irgendwo gestanden hätte. Die Angabe hier ist die korrigierte.

Empfohlen, aber nicht zwingend

Die oben genannten Werte sind das Minimum. Frischere Versionen laufen ebenso und sind die Basis, auf der Schneespur entwickelt wird:

  • Datenbank: MySQL 8.0 bzw. MariaDB 10.6
  • PHP: die jeweils aktuell gepflegte Version, derzeit 8.4 oder neuer

Wer die Wahl hat, fährt mit den neueren Versionen am ruhigsten — sie erhalten am längsten Sicherheitsupdates.

Was ausdrücklich nicht nötig ist

Schneespur ist bewusst so gebaut, dass es ohne Server-Administration auskommt:

  • Kein SSH-Zugang. Die Installation läuft über einen Browser-Assistenten.
  • Kein Docker, kein eigener Server, kein VPS. Gewöhnliches Shared-Webhosting genügt.
  • Kein Root-Zugang. Es werden keine Systempakete installiert.
  • Kein dauerhaft laufender Hintergrundprozess. Statt eines queue:work-Daemons, den ein Shared-Hoster nach wenigen Minuten beenden würde, erledigt Schneespur alle wartenden Aufgaben bei jedem Cron-Lauf und beendet sich dann wieder.

Wer einen Root-Server oder VPS besitzt, kann ihn natürlich verwenden — Pflicht ist er nicht.

Der eine Cronjob

Die einzige laufende Voraussetzung über das Hosting hinaus ist ein Cron-Job. Schneespur nutzt einen einzigen Cronjob, der jede Minute ausgeführt wird; daraus werden alle Hintergrundaufgaben gesteuert:

  • Wetterdaten abrufen — automatisch bei Einsatzstart und -ende
  • E-Mail-Benachrichtigungen versenden — asynchron nach Einsatzabschluss
  • Datenbereinigung — abgelaufene Einsatzdaten nach Ablauf der konfigurierten Aufbewahrungsfrist aggregieren und löschen
  • Update-Prüfung — täglich prüfen, ob eine neue Version verfügbar ist
  • Cron-Heartbeat — die Statusprüfung, ob der Cronjob selbst korrekt läuft

Wenn der Cronjob einmal aussetzt

Läuft der Cronjob vorübergehend nicht — etwa weil das Hosting kurz nicht erreichbar war —, gehen keine Daten verloren. Einsätze werden weiterhin korrekt erfasst; Wetterdaten und Benachrichtigungen werden beim nächsten Lauf nachgeholt. Das Dashboard zeigt an, ob der Cronjob korrekt läuft, sodass ein dauerhaftes Problem sichtbar wird.

Wie es weitergeht

Sind die Voraussetzungen erfüllt, führt ein Browser-Assistent durch die Erst-Einrichtung; die Installation dauert in der Regel etwa zehn Minuten. Den Schritt-für-Schritt-Ablauf finden Sie auf der Seite Installation. Warum Schneespur überhaupt auf eigenem Hosting läuft und was daraus folgt, erklärt die Seite Self-Hosting.