Installation auf Webhosting (Node.js)

So installieren Sie Plazello auf einem Webhosting-Paket mit Node.js-Unterstützung (z. B. Plesk oder cPanel) oder auf einem eigenen Server ohne Docker. Prüfen Sie vorher die Voraussetzungen.

1. Datenbank anlegen#

Legen Sie im Hosting-Panel eine leere Datenbank und einen Datenbank-Benutzer mit vollen Rechten darauf an – mit UTF-8 als Zeichenkodierung. Notieren Sie sich:

• Host (oft localhost oder eine im Panel angezeigte interne Adresse),
• Port (MariaDB/MySQL meist 3306, PostgreSQL 5432),
• Name der Datenbank,
• Benutzer und Passwort.

2. Installationspaket hochladen und entpacken#

Das Installationspaket enthält mehrere tausend Dateien. Laden Sie deshalb das Archiv hoch, nicht den entpackten Ordner, und entpacken Sie es auf dem Server.

• Mit SSH: Archiv per scp oder SFTP hochladen und mit unzip (bzw. tar -xzf beim .tar.gz-Archiv) entpacken. Benennen Sie den entstandenen Ordner zum Beispiel in plazello um.
• Ohne SSH: Archiv mit dem Dateimanager des Panels oder per SFTP hochladen und im Dateimanager über Entpacken auspacken.

3. Node.js-Anwendung im Panel einrichten#

Die Bezeichnungen unterscheiden sich je nach Panel: Plesk nennt die Funktion Node.js, cPanel Setup Node.js App. Tragen Sie Folgendes ein:

Speichern Sie und starten Sie die Anwendung (App neu starten / Restart App).

• Klicken Sie nicht auf npm install und führen Sie keine Skripte aus – alles ist bereits enthalten.
• Panels, die Node.js-Anwendungen über Phusion Passenger starten (z. B. Plesk und cPanel), erkennt der Shop automatisch.

4. Web-Installer aufrufen#

Öffnen Sie die Adresse Ihres Shops im Browser. Beim ersten Start erscheint der Web-Installer. Er benötigt den Installations-Code, den Sie in der Datei data/setup-token.txt im Anwendungsordner finden (Dateimanager des Panels) – er steht außerdem im Protokoll der Anwendung. Wie es weitergeht, lesen Sie unter Der Web-Installer.

Klappt der Start nicht, zeigt die Seite direkt im Browser an, woran es liegt (etwa ein falsches Datenbank-Passwort oder eine zu alte Node.js-Version), samt der letzten Protokollzeilen. Beheben Sie die Ursache, starten Sie die App im Panel neu und laden Sie die Seite erneut. Weitere Hinweise finden Sie unter Fehlerbehebung.

Eigener Server ohne Panel#

Auf einem eigenen Server starten Sie den Shop im Anwendungsordner mit:

node server.js

Der Shop lauscht standardmäßig auf Port 3000 (änderbar mit der Umgebungsvariable PORT). Richten Sie ihn als dauerhaft laufenden Dienst ein, zum Beispiel mit systemd:

[Unit]
Description=Plazello
After=network.target

[Service]
WorkingDirectory=/opt/plazello
ExecStart=/usr/bin/node server.js
Restart=always
User=plazello

[Install]
WantedBy=multi-user.target

Davor gehört ein Reverse Proxy mit HTTPS, der die Anfragen an den Port weiterleitet – mit Caddy genügt zum Beispiel:

shop.example.com {
  reverse_proxy localhost:3000
}

Bei nginx achten Sie darauf, den Host-Header sowie X-Forwarded-Proto weiterzugeben, damit der Shop seine eigene Adresse und HTTPS korrekt erkennt.

Optional: Konfiguration über .env#

Eine Konfigurationsdatei ist nicht nötig. Wer die Einstellungen lieber vorgibt (etwa bei automatisierten Installationen), kopiert die mitgelieferte Datei .env.example nach .env und setzt dort zum Beispiel DATABASE_URL (beginnend mit mariadb://, mysql:// oder postgres://), PUBLIC_URL oder PORT. Werte aus .env und aus Umgebungsvariablen haben Vorrang vor den Einstellungen im Admin und werden dort schreibgeschützt angezeigt.