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.
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.nodein derpackage.jsonoder 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 einepackage-lock.jsonvorhanden ist). - Build – das Skript
build, sofern diepackage.jsoneines enthält.
Frameworks
| Framework | Wie es läuft |
|---|---|
| Next.js | als Server (next start) – Server-Rendering, API-Routen und Middleware funktionieren wie gewohnt |
Next.js mit output: 'export' | als statische Website aus out |
| Nuxt | als Server (.output/server/index.mjs) |
Nuxt mit ssr: false und einem Skript generate | als statische Website aus .output/public |
| SvelteKit | mit adapter-node als Server; mit adapter-static als statische Website |
| Astro | als statische Website; mit @astrojs/node als Server |
| NestJS | dist/main.js nach dem Build |
| Express, Fastify, Koa, Hono und andere Server | die 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.