Wiki: Installation auf Plesk
(RED-Host Panel)

Hier werden wir dir einmal die Installation des RED-Host Panels auf Plesk erklären.

Zunächst ist es wichtig überhaupt einen Plesk-Webspace / Plesk-Webserver zu besitzen. Wenn dieser Schritt erledigt wurde, können wir mit der Installation fortfahren.

1. Schritt: Herunterladen
Wir müssen vorerst das RED-Host Panel herunterladen, dies können wir unter folgender URL vornehmen:

https://github.com/BSchleyer/redhost-panel/tree/old-original

Nachdem Du das getan hast, lädst Du die Datei auf dem Webspace entweder über die GUI oder über FTP hoch. Entpackst diese und verschiebst anschließend die Dateien in den Hauptordner der Domain oder Subdomain. Nun kannst die die .zip-Datei sowie den angefügten Ordner löschen.

2. Schritt: Umstellen der Hosting-Einstellungen
Vorausgesetzt: du verfügst über die Berechtigungen
Bei diesem Schritt erweitern wir den Dokumentenstamm. Dort müsste aktuell deine Domain oder Subdomain zu sehen sein. Dort hängst Du einfach ein:

/public

an und die Sache ist erledigt.

Bitte denke daran!
Das Panel unterstützt nur die PHP-Version 7.1 bis 7.4. An einer Unterstützung für PHP8 arbeiten wir bereits, allerdings wird dieser Prozess noch einiges an Zeit benötigen.

3. Schritt: Einrichtung der Datenbank & Konfiguration der .env
Um Datensätze verarbeiten zu können, müssen wir eine Datenbank anlegen und die in dem Panel enthaltene .sql-Datei importieren. Du solltest ebenfalls die Zugangsdaten zur Datenbank in die .env-Datei eintragen. Die .env stellt hier die Konfigurationsdatei dar.
Füge die Zugangsdaten nun unter:

DB_HOST="localhost" # database host
DB_NAME="" # database name
DB_USER="" # database username
DB_PASS="" # database password

ein. Nun sollte die Verbindung stehen.

Allerdings war das nicht alles. In der .env musst Du noch weitere Dinge konfigurieren, wie bspw. URL, Crone-Keys, Pterodactyl oder sämtliche andere Dinge. Wenn Du das getan hast, können wir fortfahren.

4. Schritt: Installation von Composer-Paketen
Gehe nun in Plesk unter dem Tab: PHP-Composer und drücke dort auf Suchen. Nachdem der Plesk PHP-Composer alle Repositorys bzw. Informationen gefunden hat, muss nur noch die Installation erfolgen. Drücke dafür auf den Button: Installieren.

5. Schritt: Einrichten von Cronjobs
Vorausgesetzt: du verfügst über die Berechtigungen

Erklärung:
Die Cronjobs sind geplante Aufgaben. Um bspw. einen Webspace oder vServer zu bestellen, wird der sogenannte Worker benötigt. Dies ist ein Cronjob der alle Aufgaben aus der Datenbank stehenden Informationen ausführt (In der Datenbank-Tabelle: queue).

Dann gibt es noch den sog. Runtime, welcher die Laufzeiten bestimmt. Runtime erledigt sogesehen alle Aufgaben, die zu den Laufzeiten anfallen - wie bspw. Setzung der verbleibenden Tage in der Datenbank des Produktes, Sperrung und Löschung der Dienste.

Gehe nun in Plesk unter dem Tab: Geplante Aufgaben (meist rechts an der Seite zu finden) und drücke auf Aufgabe hinzufügen.

Vorkonfiguration in der .env notwendig
Wie im Schritt 3 bereits schon erklärt, müssen wir auch Parameter für den Crone-Key setzen. Dafür kannst Du x-beliebige Zeichen verwenden, bei Sonderzeichen musst Du vorsichtig agieren - bestenfalls nur Buchstaben & Zahlen verwenden. In unserem Beispiel verwenden wir abc als Crone-Key (CRONE_KEY Parameter in der .env)

Worker-Cronjob eintragen:
Wähle im Aufgabentyp das Feld "URL" abrufen aus. Anschließend füllst Du das Feld der "URL" mit der konfigurierten URL (aus der .env-Datei) aus. Dann müsste dort bspw.: "https://www.schleyer-edv.de/" stehen. Nun fügen wir der URL noch einige Dinge hinzu, darunter "/crone/worker_queue/" sodass "https://www.schleyer-edv.de/crone/worker_queue/" herauskommt.

Allerdings ist das nicht alles. In der .env muss ein CRONE_KEY eingetragen werden, den Du selbst bestimmen kannst. Bspw. abc.
Das fügst Du dann ebenfalls an die URL.
Nun sollte die URL "https://www.schleyer-edv.de/crone/worker_queue/abc" lauten.

Wenn wir das erledigt haben, wählst Du in der Ausführung den Cron-Stil aus und trägst folgenden Wert ein: "* * * * *"
Jetzt wird der Cronjob jede Minute ausgeführt.

Runtime-Cronjob eintragen:
Im Grunde folgst Du dem Beispiel aus dem Worker-Cronjob. Allerdings ersetzt Du hier worker_queue mit runtime_queue. Zusätzlich muss der Cron-Stil "* /10 * * *" lauten.

6. Schritt: Einbindung deines E-Mailservers & Registrierung eines Benutzerkontos
Du kannst für die Verwendung eines E-Mailservers jegliche Art von E-Maildienst verwenden, bspw. Google-Mail, Exchange, mailcow, Plesk-Mail oder auch viele andere. Hauptsache ist, dass Du weißt, welche Daten Du in der Konfigurations-Datei für die E-Mails benötigst.

Die Konfigurationsdatei für die E-Mails findest Du in "app/notifications/sendMail.php". Dort kannst Du alle notwendigen Variablen anpassen.
Hier ein Beispiel für Dich:

$mail->Host = 'mx01.red-host.eu'; # Host
$mail->Username = 'no-reply@red-host.eu'; # Benutzername
$mail->Password = ''; # Benutzerpasswort
$mail->Port = 587; # email port
$mail->setFrom('no-reply@red-host.eu', 'REDHost - Kundencenter'); # im ersten feld benutzername, im zweiten ein fiktiver name oder env('APP_NAME')

Du kannst auch die beiden Variablen:

$mail->SMTPSecure = 'tls'; # smtp mode
$mail->SMTPAutoTLS = true; # automatic tls

überarbeiten. Allerdings kannst Du die im Normalfall gleich lassen.

Nun kannst Du deine URL im Browser abrufen und ein Benutzerkonto anlegen. Nachdem anlegen eines Benutzerkontos erhältst Du eine E-Mail mit einem Bestätigungslink, diesen drückst Du - erledigt? Dann kannst Du dich einloggen. Einstellungen zu dem Benutzer, wie bspw. Adminrechte, Guthaben oder sonstige Dinge kannst Du über phpMyAdmin (Datenbank) vornehmen.

Danke und viel Spaß mit dem RED-Host Panel!
Natürlich kannst Du auch eigene Programmierungen vornehmen, das Theme anpassen und sonstige Dinge. Du kannst dir alles nach deinen Wünschen anpassen. Bei Problemen kannst Du gerne über GitHub ein Issue eröffnen.
GitHub Issue erstellen