Jetzt starten

Node.js-, Next.js- und Nuxt-Anwendungen.

Wie Node.js-Projekte erkannt und gestartet werden: Node-Version, Paketmanager, Next.js und Nuxt (als Server oder statisch), SvelteKit, Astro, Express und Co., die Variable PORT und Prisma-Migrationen.

3 MIN. LESEZEIT

Ein Repository mit einer package.json ist ein Node.js-Projekt. Wir ermitteln Framework, Paketmanager und Node-Version, bauen das Projekt und starten es – Sie müssen nur pushen.

Node-Version und Paketmanager

  • Node.js – aus engines.node in der package.json oder aus .nvmrc: die neueste passende Version von 24, 22, 20, 18 oder 16. Fehlt beides, Node.js 22.
  • Paketmanager – anhand der Lock-Datei: pnpm-lock.yaml → pnpm, yarn.lock → yarn, sonst npm (npm ci, wenn eine package-lock.json vorhanden ist).
  • Build – das Skript build, sofern die package.json eines enthält.

Frameworks

FrameworkWie es läuft
Next.jsals Server (next start) – Server-Rendering, API-Routen und Middleware funktionieren wie gewohnt
Next.js mit output: 'export'als statische Website aus out
Nuxtals Server (.output/server/index.mjs)
Nuxt mit ssr: false und einem Skript generateals statische Website aus .output/public
SvelteKitmit adapter-node als Server; mit adapter-static als statische Website
Astroals statische Website; mit @astrojs/node als Server
NestJSdist/main.js nach dem Build
Express, Fastify, Koa, Hono und andere Serverdie Datei aus scripts.start (node server.js), sonst main, sonst server.js, app.js, index.js oder main.js

Reine Frontend-Projekte – Vite, Create React App, Angular, Vue CLI und andere – werden als statische Websites ausgeliefert; siehe Statische Websites.

Auf PORT lauschen

Ein Server muss auf dem Port aus der Variable PORT lauschen, und zwar auf allen Schnittstellen:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js und Nuxt erledigen das von selbst. Lauscht Ihre Anwendung auf einem festen Port, erreichen sie keine Besucher – das Deployment bricht dann beim Startcheck ab, und die vorherige Version läuft weiter.

Werte zur Build-Zeit

Variablen aus dem Tab Variablen stehen der laufenden Anwendung zur Verfügung, nicht dem Build. Werte, die der Build in den Client-Code schreibt – etwa NEXT_PUBLIC_… in Next.js oder VITE_… –, werden aus Ihrem Repository gelesen, zum Beispiel aus einer eingecheckten Datei .env.production. Serverseitiger Code liest den Tab Variablen wie gewohnt.

Eigener Startbefehl

Wenn der erkannte Start nicht passt, legen Sie unter Einstellungen → Build-Einstellungen → Startbefehl einen eigenen fest, z. B. node dist/server.js oder npm run start:prod. Dort lassen sich auch die Installations- und Build-Befehle ändern.

Datenbanken und Prisma

Fügen Sie dem Projekt PostgreSQL oder MySQL hinzu und lesen Sie DATABASE_URL aus – die Variable wird für Sie gesetzt. Ist Prisma unter Ihren Abhängigkeiten, empfehlen wir als Release-Befehl npx prisma migrate deploy: Er läuft bei jedem Deployment, bevor die neue Version Besucher erhält. Siehe Deployments.

Für Warteschlangen mit BullMQ fügen Sie Valkey hinzu und verwenden REDIS_URL. Den Queue-Worker betreiben Sie als Hintergrund-Worker – im Tab Prozesse oder als eigenen Dienst mit eigenen Ressourcen. Siehe Dienste eines Projekts.

Dateien, die ein Deployment überdauern

Jedes Deployment startet mit einer frischen Kopie Ihres Repositorys. Dateien, die Ihre Anwendung nach /data schreibt, bleiben zwischen Deployments erhalten und werden täglich gesichert; alles, was woanders gespeichert wird, ist nach dem nächsten Deployment weg. Für Uploads und Medien ist Object Storage meist die bessere Wahl.

Monorepos

Bei einem Repository mit mehreren Projekten geben Sie beim Anlegen der Anwendung den Projektordner an (z. B. apps/web). Ein anderer Ordner desselben Repositorys kann als separater Webdienst laufen – siehe Dienste eines Projekts.

Noch Fragen?

Schreiben Sie uns im Chat – die AI antwortet sofort, und bei Bedarf kommt ein Techniker dazu, zu jeder Tageszeit.

Support kontaktieren