Installation & Updates

OwnShift läuft auf gewöhnlichem Webhosting mit PHP. Die Daten liegen in einer SQLite-Datei; eine Datenbank müssen Sie weder anlegen noch einrichten. Das Installationspaket erhalten Sie nach dem Kauf von KOPFFREI.IT. Für eine Neuinstallation ist das Paket mit der Endung -fresh-install gedacht, für Updates das Paket ohne diese Endung.

Voraussetzungen

PHP 8.0 oder neuer mit den Erweiterungen pdo_sqlite, openssl und mbstring (getestet wird mit PHP 8.4)
Apache mit mod_rewrite, mod_headers und erlaubten .htaccess-Dateien
Schreibrechte für die Verzeichnisse data/ und logs/

Den Document-Root müssen Sie nicht umstellen: Nur der Ordner public/ ist über das Web erreichbar, die .htaccess im Hauptverzeichnis leitet dorthin um und sperrt alles andere. Ohne mod_headers läuft OwnShift, aber ohne die zusätzlichen Sicherheits-Header.

Neuinstallation

1 Den Inhalt des Fresh-Install-Pakets per FTP in ein Verzeichnis auf Ihrem Webspace hochladen.

2 Direkt danach https://ihre-domain.de/pfad/setup.php im Browser aufrufen.

3 Den ersten Administrator anlegen: Benutzername (mindestens 3 Zeichen), Passwort und Passwort bestätigen. Das Passwort braucht mindestens 8 Zeichen mit Groß- und Kleinbuchstaben, Ziffer und Sonderzeichen und darf den Benutzernamen nicht enthalten. Dann Installation starten. Die Datenbank wird dabei automatisch erzeugt.

4 setup.php entfernt sich danach selbst. Meldet die Seite, dass das nicht ging, löschen Sie die Datei von Hand. Anschließend über Zum Login anmelden.

Sicherheitshinweis: Rufen Sie setup.php direkt nach dem Hochladen auf. Bis der erste Administrator angelegt ist, könnte jeder, der die Adresse kennt, das tun.

Updates

1 Das Update-Paket (ohne -fresh-install) per FTP hochladen und die vorhandenen Dateien überschreiben. Der Ordner data/ mit Ihren Daten bleibt unberührt.

2 Als Administrator anmelden. Stehen Datenbank-Änderungen aus, öffnet sich der Update-Assistent.

3 Update starten. Der Assistent lädt vorher eine vollständige Datensicherung herunter und legt zusätzlich eine Sicherung in data/backups/ an. Danach zeigt er die Versionen vorher und nachher.

4 Kurzer Funktionstest: Anmeldung, Planung, Mitarbeiterliste.

Das Update kann nur ein Administrator ausführen. Bis dahin sehen alle anderen einen Wartungshinweis. Manche Updates beenden alle Sitzungen, dann melden sich alle Benutzer einmal neu an (so bei 0.10). Das steht jeweils unter Was ist neu?.

Datensicherung

Eine Sicherung laden Administratoren unter System > Backup herunter. Die Schlüsseldateien .2fa-key und .smtp-key im Installationsverzeichnis sind in keiner Datenbank-Sicherung enthalten und sollten einmal separat gesichert werden. Fehlen sie nach einer Wiederherstellung auf einem neuen Server, gelten Codes aus Authenticator-Apps nicht mehr und das SMTP-Passwort muss neu eingegeben werden.

Nach der Installation

Wie es weitergeht, beschreiben die Ersten Schritte.

Stand: 13.10.2026, beschreibt OwnShift 0.10