Jetzt starten
Alle BeiträgeANLEITUNG · 7 MIN. LESEZEIT

Ihre Node.js-App auf dem Rivervo-Hosting bereitstellen (Next.js und Nuxt).

RT
Rivervo Team · Rivervo
·
29. April 2026
·
Aktualisiert 13. November 2026
Node
ON SHARED HOSTING

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 build

Dadurch 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 build

Dadurch 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.

FrameworkDiese Dateien hochladenWeglassen
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/ und package.json liegen).
  • 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 3000 zurü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.mjs von Nuxt (den Einstiegspunkt, den npm run build erzeugt).
  • 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.

FeldWert
Version20 oder neuer
ModusProduktion
Ordnermyapp in Ihrem Home-Verzeichnis (wohin Sie die Dateien hochgeladen haben)
Adresseihredomain.de (oder eine Subdomain wie app.ihredomain.de)
Startdateiserver.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.json im Stammverzeichnis der Anwendung liegt (nicht verschachtelt).
  • Für Next.js: Stellen Sie sicher, dass next unter dependencies steht, nicht unter devDependencies (die Produktionsinstallation überspringt Dev-Abhängigkeiten).
  • Für Nuxt: Auch nuxt selbst 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 app

Haben 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.js

Arbeitsspeicher: 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

  1. npm run build lokal ausführen
  2. .next/ (Next) bzw. .output/ (Nuxt) + package.json + server.cjs hochladen
  3. Website → Node.js und Python → Node.js-Anwendung → Ordner, Startdatei server.cjs, Modus Produktion
  4. 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