Installation

Stehen Datenbank und Domain bereit, dauert es eine Viertelstunde.

1. Dateien auf den Server bringen

Auf dem Zielserver:

curl -fLO https://gitlab.com/mankeldor/shortlink/-/raw/main/shortlink-setup.sh
sh shortlink-setup.sh /pfad/zur/installation

Das Skript holt das neueste Release, prüft die Prüfsumme, entpackt es, installiert die PHP-Abhängigkeiten und führt shortlink:check aus.

Sieh dir das Skript an, bevor du es ausführst.

sh shortlink-setup.sh --help listet alle.

Das Skript sieht sich das Zielverzeichnis an: leer heißt Erstinstallation, eine erkennbare Shortlink-Installation heißt Aktualisierung, alles andere heißt Abbruch ohne Download und ohne Überschreiben.

Andere Wege: Release-Paket von Hand · Repository klonen · GitLab CI/CD

Hier endet das Skript

Es richtet nicht ein. Die Dateien liegen, die Abhängigkeiten sind installiert — die .env, die Datenbank und der erste Administrator fehlen noch. Datenbank- und Administrator-Passwort stünden in einer Skript-Befehlszeile in der Prozessliste und in der Shell-Historie.

Für die Einrichtung gibt es zwei gleichwertige Wege, beide in Schritt 3:

Weg	Aufruf	Wann
Terminal	cd /pfad/zur/installation && php artisan shortlink:install	Du bist ohnehin per SSH da. Der einzige Weg, der sich automatisieren lässt (--no-interaction)
Browser	Domain auf /pfad/zur/installation/public zeigen lassen, dann /install aufrufen	Die Domain steht bereits. Vier Schritte mit Erklärungen an jedem Feld

Beide stellen dieselben Fragen und tun dasselbe. Was du nimmst, ändert nichts am Ergebnis.

Bei einer Aktualisierung entfällt das: Dort läuft das Skript vollständig durch, weil die .env schon steht und keine Geheimnisse abzufragen sind.

2. Verzeichnisse und Rechte prüfen

Das Setup-Skript hat diese Prüfung schon ausgeführt. Auf den anderen Wegen und um einen Befund zu beheben:

php artisan shortlink:check

Fehlen Verzeichnisse:

mkdir -p storage/framework/views storage/framework/cache/data \
         storage/framework/sessions storage/logs \
         storage/app/private storage/app/public bootstrap/cache

Fehlt das Schreibrecht — <web-user> ist der Nutzer, unter dem PHP läuft (www-data, nginx, bei Shared Hosting meist dein eigener):

chown -R <web-user>:<web-group> storage bootstrap/cache
chmod -R u+rwX storage bootstrap/cache

Der Befehl nennt in beiden Fällen die betroffenen Pfade und den passenden Aufruf.

3. Einrichten

Weg A: Kommandozeile

cd /pfad/zur/installation
php artisan shortlink:install

Prüft die Voraussetzungen, fragt Datenbank, Adresse und ersten Administrator ab und richtet ein. Werte aus einer vorhandenen .env sind vorbelegt. Die Kommandozeile ist englisch.

Ohne Rückfragen, für automatisiertes Deployment:

php artisan shortlink:install --no-interaction \
    --db-database=shortlink --db-username=shortlink --db-password='…' \
    --url=https://beispiel.de \
    --admin-name='Vorname Nachname' --admin-email=admin@beispiel.de --admin-password='…' \
    --update-check=false

Beides landet als SHORTLINK_UPDATE_CHECK und SHORTLINK_UPDATE_SOURCE in der .env und ist dort änderbar.

Weg B: Browser

Lass die Domain auf /pfad/zur/installation/public zeigen, rufe https://beispiel.de/install auf und folge den vier Schritten: Voraussetzungen, Datenbank, Administrator, fertig.

Im Schritt „Datenbank" steht neben den Zugangsdaten die vorbelegte Auswahl „Auf neue Fassungen prüfen". Die Quelle der Release-Liste lässt sich nur in der .env ändern (SHORTLINK_UPDATE_SOURCE).

Diese Adresse ist ohne Anmeldung erreichbar, solange kein Administrator existiert. Sobald der erste angelegt ist, antwortet sie mit 404. Lass eine frisch hochgeladene Installation nicht tagelang offen stehen.

4. Cron einrichten

Zwei Einträge, beide nötig: Cron einrichten.

5. Nach der Installation

Zehn Schritte in fester Reihenfolge, beginnend mit dem Mail-Versand: Nach der Installation.

Wenn etwas nicht läuft

Ausführlich: Störungssuche.