Schnellinstallation - Anleitungen

Diese Anleitung wurde auf Ubuntu 22.04 getestet.
Unter anderen Distributionen können Befehle, Pfade oder Einstellungen abweichen.

Voraussetzungen

Bitte überprüfe vor der Installation, ob dein System alle nötigen Voraussetzungen erfüllt. Die Voraussetzungen findest du hier: Voraussetzungen

Allgemein

QUIQQER lässt sich über zwei Methoden installieren:

Per Websetup: wird per Browser mit einer grafische Oberfläche durchgeführt
Per Terminal: nur möglich, wenn man Konsolen-Zugriff (ssh) auf den Server hat

Im Regelfall sollte das Websetup verwendet werden. Das Konsolen Setup ist auf erfahrene Benutzer ausgelegt.

Eine Anleitung für die jeweilige Methode findest du unter:

QUIQQER kann auch nicht-interaktiv installiert werden: QUIQQER non-interactive setup

Konfiguration

Nach der Installation musst du je nach eingesetztem Webserver noch kleine Schritte erledigen, bevor du dich in den Adminbereich einloggen kannst.

Webserver: Apache

QUIQQER generiert automatisch eine .htaccess Datei, welche Webserver Einstellungen enthält, die für QUIQQER benötigt werden. Wenn der Webserver so konfiguriert ist, dass er .htaccess Dateien einliest und verwendet, sollte QUIQQER bereits einsatzbereit sein.

Webserver: NGINX

Die Dokumentation zur Konfiguration zu NGINX ist hier zu finden

Troubleshooting

Der Adminbereich ist nicht verfügbar

Dies kann folgende Ursachen haben:

Das Apache Module rewrite ist nicht aktiviert
Der Apache Server verwendet keine .htaccess Dateien
Die .htaccess Datei wurde nicht generiert
NGINX ist nicht richtig konfiguriert

Lösung 1: Das Rewrite Modul kann per Konsole aktiviert werden (Apache)

a2enmod rewrite
service apache2 restart

Lösung 2: Stelle sicher, dass dein Apache das überschrieben von Konfigurationsdirektiven durch die .htaccess Datei erlaubt

Hierfür zuständig ist die AllowOverride Direktive. Häufig wird diese in einer Directory Sektion verwendet:

<Directory /pfad/zum/QUIQQER/root/verzeichnis>
    Options Indexes FollowSymLinks
    AllowOverride All
    Order allow,deny
    allow from all
</Directory>

Lösung 3: Die .htaccess Datei kann manuell per Konsolen Tool generiert werden

Hierfür muss im Hauptverzeichnis von QUIQQER Folgendes ausgeführt werden:

./console htaccess

Dies generiert eine neue .htaccess Datei.

Ich erhalte beim ersten Aufruf nach der Installation einen Server Error mit dem HTTP Statuscode `500`!

Ein Statuscode von 500 bedeutet, dass ein unbekannter Fehler auf dem Server passiert ist.
Dies kann mehrere Ursachen haben.
Allerdings ist die wahrscheinlichste Ursache nach dem Setup, dass die Dateirechte falsch gesetzt sind und der Webserver die Dateien nicht beschreiben oder aufrufen kann.
Prüfe bitte die Dateirechte und den Besitzer der Dateien. Meistens verwendet der Webserver den Benutzer www-data.

installation