Ihre Node.js-App auf dem Rivervo-Hosting bereitstellen (Next.js und Nuxt).
Viele glauben, Node.js-Apps müssten auf einem VPS laufen. Das stimmt nicht – jeder Shared-Hosting-Tarif von Rivervo bietet im Website-Menü Node.js und Python. Dort wird für Ihre App ein Phusion-Passenger-Prozess gestartet, hinter demselben Apache-Frontend, das auch Ihre anderen Websites ausliefert.
Diese Anleitung führt Sie durch den gesamten Ablauf für die zwei verbreitetsten Frameworks: Next.js und Nuxt 3. Das Ergebnis: Ihre App unter https://ihredomain.de (oder einer beliebigen Subdomain), in einem echten Node.js-Prozess, der Neustarts übersteht und sich mit einem Klick neu starten lässt.
Wenn Sie noch nie eine Node-App auf Shared Hosting bereitgestellt haben: Die meisten hängen an der Startdatei fest. Passenger braucht ein einzelnes Einstiegsskript, das Ihr Framework startet. Für jedes Framework finden Sie unten eines – einfach kopieren, keine Anpassungen nötig.
Was Sie vorab brauchen
- Einen Rivervo-Hosting-Tarif (jeder Tarif – Node.js-Apps laufen in allen Tarifen)
- Lokal Node.js v20 oder neuer, um Ihre App zu bauen
- Das fertige Build-Ergebnis zum Hochladen (dazu gleich mehr je Framework)
- Zugriff über den Dateimanager oder SFTP (beides funktioniert)
Sie brauchen kein Root, kein sudo, kein systemd und keine Reverse-Proxy-Konfiguration. Das alles übernimmt Passenger.
Schritt 1 – App lokal bauen
Sie laden eine fertig gebaute App hoch, nicht den Quellcode. Das Panel installiert Abhängigkeiten, kompiliert aber kein React und führt keinen Vite-Build aus. Erledigen Sie das zuerst auf Ihrem Rechner.
Next.js:
npm ci
npm run buildDadurch entsteht .next/ (das Build-Ergebnis). Führen Sie hier kein next start aus – wir starten die App gleich über die Startdatei.
Nuxt 3:
npm ci
npm run buildDadurch entsteht .output/ (das universelle Build-Verzeichnis von Nuxt). Auch hier gilt: noch nichts starten.
Schritt 2 – die richtigen Dateien hochladen
node_modules/ müssen Sie nicht hochladen. Das Panel installiert die Abhängigkeiten für Sie. Auch Git- oder Build-Caches brauchen Sie nicht.
Laden Sie die Dateien in Ihr Konto hoch, am besten in einen Pfad außerhalb von public_html (z. B. /home/<account>/myapp/). Warum außerhalb? Weil Passenger public_html automatisch im URL-Stamm einbindet und Ihr App-Code dort öffentlich zugänglich wäre.
| Framework | Diese Dateien hochladen | Weglassen |
|---|---|---|
| Next.js | .next/, public/, package.json, package-lock.json, next.config.js, Ihre server.cjs (siehe unten) | node_modules/, .git/, .env.local |
| Nuxt 3 | .output/, package.json, package-lock.json, Ihre server.cjs (siehe unten) | node_modules/, .nuxt/, .git/, Quellcode in pages/, components/ |
Zwei Wege, die Dateien hochzuladen:
- Website → Dateien → ZIP-Datei hochladen → entpacken ist am einfachsten, wenn Ihre Verbindung instabil ist.
- SFTP (FileZilla, Cyberduck,
rsync) ist bei wiederholten Deployments schneller. Server, Port, Benutzername und Passwort finden Sie unter Website → SSH und SFTP.
Schritt 3 – die Startdatei hinzufügen
Diese Datei führt Passenger bei eingehenden Anfragen aus. Legen Sie sie in Ihrem App-Ordner neben package.json ab.
Für Next.js – server.cjs
const next = require('next')
const http = require('http')
const port = process.env.PORT || 3000
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev, dir: __dirname })
const handle = app.getRequestHandler()
app.prepare().then(() => {
http.createServer((req, res) => handle(req, res)).listen(port, () => {
console.log(`Next.js server listening on port ${port}`)
})
})Was sie tut:
- Lädt Next und verweist auf das aktuelle Verzeichnis (in dem
.next/undpackage.jsonliegen). - Erstellt einen Request-Handler aus dem internen Router von Next.
- Startet einen HTTP-Server auf dem Port, den Passenger zuweist (
process.env.PORT). - Greift für lokale Tests auf
3000zurück.
dev wird automatisch aus NODE_ENV abgeleitet – stellen Sie im Panel den Modus Produktion ein (das machen wir in Schritt 4), dann läuft Next im Produktionsmodus.
Für Nuxt 3 – server.cjs
import('./.output/server/index.mjs').then(({ createApp }) => {
createApp().then(({ app }) => {
const port = process.env.PORT || 3000
app.listen(port, () => {
console.log(`Nuxt server listening on port ${port}`)
})
})
})Was sie tut:
- Importiert dynamisch
.output/server/index.mjsvon Nuxt (den Einstiegspunkt, dennpm run builderzeugt). - Erstellt mit
createApp()die H3-Serverinstanz. - Lauscht auf dem von Passenger zugewiesenen Port.
Der dynamische import() ist Absicht – .mjs-Module lassen sich nicht per require() laden, eine .cjs-Datei kann sie aber dynamisch importieren. Das ist das sauberste Muster, das innerhalb des Passenger-Launchers funktioniert.
Schritt 4 – die Anwendung im Panel anlegen
Öffnen Sie Ihr Projekt → Website → Node.js und Python → Node.js-Anwendung.
| Feld | Wert |
|---|---|
| Version | 20 oder neuer |
| Modus | Produktion |
| Ordner | myapp in Ihrem Home-Verzeichnis (wohin Sie die Dateien hochgeladen haben) |
| Adresse | ihredomain.de (oder eine Subdomain wie app.ihredomain.de) |
| Startdatei | server.cjs |
Klicken Sie auf Erstellen. Unter ~/nodevenv/myapp/20/ wird eine Node.js-Umgebung angelegt.
Abhängigkeiten installieren
Sobald die App angelegt ist, klicken Sie bei ihr auf Abhängigkeiten installieren (npm install) und verfolgen Sie die Ausgabe. Schlägt es fehl:
- Prüfen Sie, ob
package.jsonim Stammverzeichnis der Anwendung liegt (nicht verschachtelt). - Für Next.js: Stellen Sie sicher, dass
nextunterdependenciessteht, nicht unterdevDependencies(die Produktionsinstallation überspringt Dev-Abhängigkeiten). - Für Nuxt: Auch
nuxtselbst sollte eine reguläre Abhängigkeit sein.
Umgebungsvariablen hinzufügen
In den Einstellungen der App → Umgebungsvariablen → Variable hinzufügen. Der Modus Produktion setzt NODE_ENV=production bereits.
Für Next.js-Apps, die zur Laufzeit Werte lesen (Datenbank-URLs, API-Schlüssel), tragen Sie diese hier ein. Liefern Sie keine .env-Datei mit Geheimnissen aus – die Umgebungsvariablen der App sind der richtige Ort dafür.
Beim Speichern der Einstellungen wird die App neu gestartet, die neuen Variablen gelten also sofort.
Schritt 5 – prüfen
Rufen Sie die URL Ihrer Anwendung auf. Sie sollten Ihre App sehen.
Erscheint eine Fehlerseite von Passenger, klappen Sie sie auf und schauen Sie ganz nach unten – dort steht fast immer ein klarer Stacktrace. Die zwei häufigsten Fehler:
Error: Cannot find module 'next' – npm install wurde nicht oder im falschen Ordner ausgeführt. Klicken Sie erneut auf Abhängigkeiten installieren (npm install).
Error: ENOENT: no such file or directory, open '.next/...' – Sie haben den Quellcode hochgeladen, aber nicht das gebaute Verzeichnis .next/. Bauen Sie lokal und laden Sie erneut hoch.
Updates bereitstellen
Wiederholen Sie die Schritte 1 und 2 und klicken Sie bei der App auf Neu starten. Im Einzelnen:
1. Build locally npm run build
2. Upload .next/ or .output/, plus any changed source/config
3. Panel Restart the appHaben Sie package.json geändert, klicken Sie vor dem Neustart auf Abhängigkeiten installieren (npm install). Sie arbeiten lieber auf der Kommandozeile? Unter Website → Terminal zeigt die App-Karte den Befehl, mit dem Sie in ihre Umgebung wechseln.
Typische Stolperfallen
WebSockets: Passenger unterstützt HTTP/1.1 und HTTP/2. Das WebSocket-Upgrade funktioniert für die integrierten Routen von Next.js und Nuxt. Nutzen Sie einen separaten WebSocket-Server (ws, socket.io), teilt er sich denselben Port und startet über dieselbe server.cjs – ohne zusätzliche Konfiguration.
Datei-Uploads / body-parser-Limits in next.config.js: Das Standardlimit von Passenger für den Request-Body liegt bei 10 MB. Wenn Sie große Dateien hochladen, setzen Sie passenger_max_request_size per .htaccess in public_html höher:
PassengerMaxRequestSize 52428800(50 MB in Bytes.)
Cronjobs: Braucht Ihre App Hintergrundaufgaben (Newsletter-Versand, geplante Exporte), führen Sie diese nicht im Webprozess aus. Rufen Sie stattdessen über Website → Cronjobs direkt ein Node-Skript auf:
/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.jsArbeitsspeicher: Passenger startet Ihre App neu, wenn sie das RAM-Limit pro Konto überschreitet (abhängig von Ihrem Tarif). Eine typische Next.js- oder Nuxt-App braucht im Leerlauf unter 100 MB. Stoßen Sie an Grenzen, analysieren Sie mit process.memoryUsage() und suchen Sie nach Speicherlecks, bevor Sie annehmen, dass Sie einen größeren Tarif brauchen.
Eigene Domains und HTTPS: Passenger bindet die Adresse, die Sie für die App festlegen. SSL läuft automatisch – ohne zusätzliche Konfiguration. Für eine weitere Domain oder Subdomain fügen Sie diese zuerst unter Website → Domains hinzu und wählen sie dann als Adresse der App.
Node-Version: Die Liste Version zeigt alle installierten Versionen; wechseln Sie sie in den Einstellungen der App.
Wann Shared Hosting für Node nicht passt
Ganz offen: Node.js auf Shared Hosting eignet sich hervorragend für Portfolio-Websites, Blogs, Marketingseiten, kleine SaaS-Frontends und interne Tools. Schwierig wird es bei:
- APIs mit hohem Durchsatz (dauerhaft >50 Anfragen/s) – hier spüren Sie das CPU-Limit pro Konto
- WebSocket-lastigen Apps mit Tausenden gleichzeitigen Verbindungen
- Apps, die Worker-Prozesse starten (Queue-Worker, Scraper) – das Prozessbudget pro Konto bei Passenger macht das umständlich
- Allem, was systemd, Docker oder Root-Zugriff braucht
Dafür ist unser VPS die richtige Wahl – voller Root-Zugriff, eigener Kernel, es läuft, was Sie möchten. Für die meisten Next.js- und Nuxt-Apps ohne riesigen Traffic ist diese Anleitung aber alles, was Sie brauchen.
Kurz zusammengefasst
npm run buildlokal ausführen.next/(Next) bzw..output/(Nuxt) +package.json+server.cjshochladen- Website → Node.js und Python → Node.js-Anwendung → Ordner, Startdatei
server.cjs, Modus Produktion - Abhängigkeiten installieren (npm install), dann Neu starten
Wenn etwas nicht funktioniert, eröffnen Sie ein Ticket – fügen Sie die Fehlerseite von Passenger ein, und wir zeigen Ihnen die betreffende Zeile.
— Ihr Rivervo-Team