Node.js-Anwendung einrichten

Eine Node.js-Anwendung meldest du im Hosting-Panel an — mit Anwendungswurzel, Startdatei und Node-Version. Das Panel startet die App über einen Application-Server und hält sie am Laufen. Einrichten kannst du das in Plesk unter Node.js, in cPanel unter Setup Node.js App.

Voraussetzungen

• Zugang zum Hosting-Panel — siehe Anmeldung am Hosting-Panel.
• Die Anwendungsdateien auf dem Server, inklusive package.json. Am saubersten per Git-Deployment oder SSH.

Schritt für Schritt

Plesk

1. Melde dich am Plesk-Panel an.
2. Öffne Websites & Domains und wähl die Domain.
3. Klick auf Node.js.
4. Wähl die Node.js-Version und trage die Anwendungswurzel sowie die Startdatei (z. B. app.js) ein.
5. Klick auf NPM installieren, um die Abhängigkeiten aus der package.json einzuspielen.
6. Klick auf Aktivieren bzw. Neu starten.

cPanel

1. Melde dich am cPanel an.
2. Öffne im Bereich Software die Setup Node.js App.
3. Klick auf Create Application.
4. Wähl die Node-Version und den Application mode (Production), trage Application root, Application URL und Application startup file ein.
5. Klick auf Create.
6. Klick anschließend auf Run NPM Install.

Änderungen brauchen einen Neustart

Der Application-Server hält deinen Code im Speicher. Nach einem Deployment oder einer Änderung an den Abhängigkeiten läuft die alte Version weiter, bis du die App über den Neu starten-Button im Panel neu startest.

Wenn etwas schiefläuft

Die Anwendung startet nicht oder liefert 503

Meist zeigt die Startdatei ins Leere, oder die App bricht beim Start mit einem Fehler ab.

Lösung: Startdatei und Anwendungswurzel prüfen, dann das Anwendungs-Log ansehen. Häufig fehlt schlicht der npm install-Lauf — hol ihn über den Button im Panel nach.

Cannot find module …

Die Abhängigkeiten aus der package.json sind nicht installiert.

Lösung: NPM installieren bzw. Run NPM Install im Panel ausführen. Auf der Shell zuerst die vom Panel angezeigte Umgebung aktivieren, damit npm die richtige Node-Version nutzt.

Nach dem Deployment läuft weiter der alte Stand

Der Application-Server hat den neuen Code noch nicht geladen.

Lösung: Die App im Panel neu starten. Wer per Git deployt, kann den Neustart als Deployment-Schritt automatisieren.

Verwandte Artikel

• Git-Deployment einrichten — die App sauber auf den Server bringen.
• SSH-Zugang einrichten — für npm-Befehle und Logs auf der Kommandozeile.
• Cronjob einrichten — für wiederkehrende Node-Skripte abseits der Web-App.

Du kommst nicht weiter?

Startet die App trotz korrekter Startdatei nicht oder hakt es bei den Abhängigkeiten? Ticket im Kundencenter öffnen — nenn die Domain, die Node-Version und die Fehlermeldung aus dem Log.