Installation (technische Referenz)

Diese Seite fasst die Installation aus Betreiber-Sicht knapp zusammen und verweist auf das, was an anderer Stelle ausführlicher steht. Die bebilderte Schritt-für-Schritt-Anleitung mit Screenshots des Browser-Assistenten finden Sie auf der Seite Installation — diese Referenz hier konzentriert sich auf die Punkte, die im Betrieb erfahrungsgemäß Rückfragen auslösen.

Die technischen Voraussetzungen (PHP, Datenbank, Erweiterungen, Cron) stehen unter Systemvoraussetzungen.

Reihenfolge im Überblick

1. Signiertes ZIP-Paket des aktuellen Releases laden.
2. Inhalt per FTP in einen Unterordner des Webhostings übertragen (z. B. /schneespur/).
3. Document-Root der Domain auf public/ setzen (siehe nächster Abschnitt).
4. Domain aufrufen — der Browser-Assistent fragt die Datenbank-Zugangsdaten ab und legt das erste Admin-Konto an. Eine leere Datenbank genügt; die Tabellen legt Schneespur selbst an.
5. Cron-Job einrichten (siehe übernächster Abschnitt).
6. Fahrer anlegen und deren GPS-Quelle verbinden — siehe OwnTracks einrichten.

Warum das Document-Root auf public/ zeigen muss

Schneespur folgt dem üblichen Public-Folder-Muster von Laravel: Nur das Verzeichnis public/ gehört in den öffentlich erreichbaren Bereich; der gesamte übrige Anwendungs-Code liegt außerhalb des Webroots.

Setzen Sie das Document-Root Ihrer Domain also auf …/schneespur/public/, nicht auf …/schneespur/. Wer diesen Schritt überspringt, stellt Anwendungs-Code und Konfigurationsdateien offen ins Netz. Falls Ihr Hoster keinen Unterordner als Document-Root zulässt, verschieben Sie den Inhalt von public/ ins Zielverzeichnis und passen die Pfade in index.php entsprechend an.

Der Cron-Job

Schneespur braucht einen einzigen Cron-Job, der jede Minute läuft. Die genaue aufzurufende Adresse zeigt der Assistent am Ende der Installation an; bei den großen Hostern legen Sie den Job im Web-Interface an. Was dieser Cron-Job im Betrieb alles erledigt und warum kein dauerhafter Hintergrundprozess nötig ist, steht unter Updates & Cron im Betrieb.

Nach der Installation

Eine knappe Betriebs-Checkliste für die ersten Minuten:

• Cron-Job angelegt und läuft jede Minute (das Dashboard zeigt den Status an)
• mindestens ein Fahrer angelegt und dessen OwnTracks-Verbindung steht
• ein Test-Einsatz angelegt und ein PDF-Einsatznachweis erzeugt
• die automatische Update-Prüfung wie gewünscht aktiviert oder deaktiviert
• die DSGVO-Aufbewahrungsfrist auf den gewünschten Wert gesetzt

Während der Einrichtung hilft zusätzlich die in die Software integrierte Dokumentation — sie ist exakt zur installierten Version passend.