Aan de slag
Alle artikelenHANDLEIDING · 7 MIN LEESTIJD

Je Node.js-app op Rivervo-hosting zetten (Next.js en Nuxt).

RT
Rivervo Team · Rivervo
·
29 april 2026
·
Bijgewerkt 13 november 2026
Node
ON SHARED HOSTING

Veel mensen denken dat Node.js-apps op een VPS moeten draaien. Dat hoeft niet — elk Rivervo-pakket voor gedeelde hosting heeft Node.js en Python in het websitemenu. Daarmee start je een Phusion Passenger-proces voor je app, achter dezelfde Apache-front-end die ook je andere sites serveert.

Deze handleiding loopt het hele proces door voor de twee meest gebruikte frameworks: Next.js en Nuxt 3. Het eindresultaat: je app op https://jouwdomein.nl (of een subdomein), draaiend op een echt Node.js-proces, bestand tegen herstarts en met één klik opnieuw te starten.

Heb je nog nooit een Node-app op gedeelde hosting gezet, dan is het startbestand het punt waar iedereen vastloopt — Passenger heeft één startscript nodig dat je framework opstart. Hieronder vind je er een voor elk framework; kopiëren, plakken, niets aanpassen.

Wat je nodig hebt

  • Een Rivervo-hostingpakket (elk pakket — Node.js-apps werken op alle pakketten)
  • Lokaal Node.js v20 of nieuwer om je app te bouwen
  • De gebouwde app, klaar om te uploaden (dat behandelen we per framework)
  • Toegang via Bestandsbeheer of SFTP tot je account (allebei goed)

Je hebt geen root, sudo, systemd of reverse-proxyconfiguratie nodig. Passenger regelt dat allemaal.

Stap 1 — bouw je app lokaal

Je uploadt een gebouwde app, niet de broncode. Het paneel installeert de afhankelijkheden, maar compileert geen React en draait geen Vite-build. Dat doe je eerst op je eigen computer.

Next.js:

npm ci
npm run build

Dat levert .next/ op (de gebouwde uitvoer). Draai hier geen next start — we starten de app straks vanuit het startbestand.

Nuxt 3:

npm ci
npm run build

Dat levert .output/ op (de universele buildmap van Nuxt). Ook hier: nog niets starten.

Stap 2 — upload de juiste bestanden

node_modules/ hoef je niet te uploaden. Het paneel installeert de afhankelijkheden voor je. Git en buildcaches heb je ook niet nodig.

Upload naar je account, bij voorkeur naar een pad buiten public_html (bijv. /home/<account>/myapp/). Waarom buiten? Omdat Passenger public_html automatisch op de hoofd-URL zet, en je appcode daar dus voor iedereen zichtbaar zou zijn.

FrameworkUpload ditSla over
Next.js.next/, public/, package.json, package-lock.json, next.config.js, je server.cjs (zie hieronder)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, je server.cjs (zie hieronder)node_modules/, .nuxt/, .git/, bron-pages/, components/

Er zijn twee manieren om de bestanden erop te krijgen:

  • Website → Bestanden → een zip uploaden → uitpakken is het makkelijkst als je verbinding niet stabiel is.
  • SFTP (FileZilla, Cyberduck, rsync) is sneller als je vaak deployt. Server, poort, gebruiker en wachtwoord vind je onder Website → SSH en SFTP.

Stap 3 — voeg het startbestand toe

Dit is het bestand dat Passenger uitvoert als er een verzoek binnenkomt. Zet het naast package.json in de map van je app.

Voor 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}`)
  })
})

Wat het doet:

  • Laadt Next en wijst het naar de huidige map (waar je .next/ en package.json staan).
  • Maakt een request-handler op basis van de interne router van Next.
  • Start een HTTP-server op de poort die Passenger toewijst (process.env.PORT).
  • Valt terug op 3000 om lokaal te testen.

dev wordt automatisch afgeleid van NODE_ENV — kies in het paneel de modus Production (dat doen we in stap 4) en Next draait in productiemodus.

Voor 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}`)
    })
  })
})

Wat het doet:

  • Importeert dynamisch .output/server/index.mjs van Nuxt (het startpunt dat npm run build maakt).
  • Gebruikt createApp() om de H3-serverinstantie op te bouwen.
  • Luistert op de poort die Passenger toewijst.

De dynamische import() is bewust — .mjs-modules kun je niet met require() laden, maar een .cjs-bestand kan ze wel dynamisch importeren. Dit is het netste patroon dat binnen de launcher van Passenger werkt.

Stap 4 — maak de applicatie aan in het paneel

Open je project → Website → Node.js en Python → Node.js-applicatie.

VeldWaarde
Versie20 of nieuwer
ModusProduction
Mapmyapp in je thuismap (waar je de bestanden hebt geüpload)
Adresjouwdomein.nl (of een subdomein zoals app.jouwdomein.nl)
Startbestandserver.cjs

Klik op Aanmaken. Er wordt een Node.js-omgeving gemaakt in ~/nodevenv/myapp/20/.

Afhankelijkheden installeren

Klik na het aanmaken bij de app op Afhankelijkheden installeren (npm install) en volg de uitvoer. Mislukt het:

  • Controleer of package.json in de hoofdmap van de applicatie staat (niet in een submap).
  • Voor Next.js: controleer of next in dependencies staat en niet in devDependencies (een productie-installatie slaat dev-afhankelijkheden over).
  • Voor Nuxt: ook nuxt zelf moet een gewone afhankelijkheid zijn.

Omgevingsvariabelen toevoegen

Instellingen van de app → Omgevingsvariabelen → Variabele toevoegen. De modus Production zet NODE_ENV=production al voor je.

Leest je Next.js-app tijdens het draaien waarden in (database-URL's, API-sleutels), voeg ze dan hier toe. Zet geen .env-bestand met geheimen online — de omgevingsvariabelen van de app zijn daar de juiste plek voor.

Bij het opslaan van de instellingen herstart de app, dus de nieuwe variabelen gelden meteen.

Stap 5 — controleren

Open de URL van je applicatie. Je zou je app moeten zien.

Zie je een foutpagina van Passenger, klap die dan uit en kijk onderaan — daar staat bijna altijd een duidelijke stacktrace. De twee meest voorkomende:

Error: Cannot find module 'next' — npm install is niet gedraaid, of in de verkeerde map. Klik opnieuw op Afhankelijkheden installeren (npm install).

Error: ENOENT: no such file or directory, open '.next/...' — je hebt de broncode geüpload maar niet de gebouwde map .next/. Bouw lokaal en upload opnieuw.

Updates uitrollen

Herhaal stap 1 en 2 en klik bij de app op Herstarten. Concreet:

1. Lokaal bouwen    npm run build
2. Uploaden         .next/ of .output/, plus gewijzigde bron/config
3. Paneel           Herstart de app

Wijzig je package.json, klik dan vóór het herstarten op Afhankelijkheden installeren (npm install). Liever de opdrachtregel? Website → Terminal: op de kaart van de app staat de opdracht om de omgeving ervan te openen.

Valkuilen

WebSockets: Passenger ondersteunt HTTP/1.1 en HTTP/2. WebSocket-upgrades werken voor de ingebouwde routes van Next.js en Nuxt. Gebruik je een aparte WebSocket-server (ws, socket.io), dan deelt die dezelfde poort en start die via dezelfde server.cjs — geen extra configuratie.

Bestandsuploads / body-parser-limieten in next.config.js: de standaardlimiet van Passenger voor de grootte van een verzoek is 10 MB. Upload je grote bestanden, zet passenger_max_request_size dan hoger via .htaccess in public_html:

PassengerMaxRequestSize 52428800

(50 MB in bytes.)

Cronjobs: heeft je app achtergrondtaken nodig (nieuwsbrieven versturen, geplande exports), draai die dan niet in het webproces. Gebruik Website → Cronjobs om direct een Node-script aan te roepen:

/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.js

Procesgeheugen: Passenger herstart je app als die boven de RAM-limiet per account komt (afhankelijk van je pakket). Een gemiddelde Next.js- / Nuxt-app gebruikt in rust minder dan 100 MB. Loop je tegen de limiet aan, analyseer dan eerst met process.memoryUsage() en zoek naar lekken voordat je aanneemt dat je een groter pakket nodig hebt.

Eigen domeinen en HTTPS: het adres dat je voor de app instelt, is waar Passenger aan koppelt. SSL gaat automatisch — geen extra configuratie. Voor een ander domein of een subdomein voeg je dat eerst toe onder Website → Domeinen en kies je het daarna als adres van de app.

Node-versie: de lijst Versie toont elke geïnstalleerde versie; wissel in de Instellingen van de app.

Wanneer je geen gedeelde hosting voor Node gebruikt

Eerlijk is eerlijk — Node.js op gedeelde hosting werkt prima voor portfoliosites, blogs, marketingpagina's, kleine SaaS-front-ends en interne tools. Het heeft moeite met:

  • API's met veel verkeer (>50 verzoeken/sec langdurig) — dan merk je de CPU-limiet per account
  • Apps die zwaar op WebSockets leunen, met duizenden gelijktijdige verbindingen
  • Apps die workerprocessen starten (queue-workers, scrapers) — het procesbudget per account van Passenger maakt dat lastig
  • Alles wat systemd, Docker of root-toegang nodig heeft

Daarvoor is onze VPS de juiste stap — volledige root, je eigen kernel, draait wat je maar wilt. Maar voor de meeste Next.js- en Nuxt-apps zonder enorm veel verkeer is deze handleiding alles wat je nodig hebt.

Kort samengevat

  1. Lokaal npm run build
  2. Upload .next/ (Next) of .output/ (Nuxt) + package.json + server.cjs
  3. Website → Node.js en Python → Node.js-applicatie → de map, startbestand server.cjs, modus Production
  4. Afhankelijkheden installeren (npm install), dan Herstarten

Doet er iets raar, open dan een ticket — plak de foutpagina van Passenger erin en we wijzen je de regel aan.

— Team Rivervo