Kom i gang
Alle indlægVEJLEDNING · 7 MIN. LÆSNING

Kør din Node.js-app på Rivervo-hosting (Next.js og Nuxt).

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

Mange tror, at Node.js-apps skal ligge på en VPS. Det skal de ikke — alle Rivervos webhotelpakker har Node.js og Python i hjemmesidens menu, som starter en Phusion Passenger-proces til din app bag den samme Apache-front, som leverer dine andre sider.

Guiden gennemgår hele forløbet for de to mest udbredte frameworks: Next.js og Nuxt 3. Slutresultatet: din app på https://ditdomaene.dk (eller et subdomæne), der kører på en rigtig Node.js-proces, overlever genstarter og kan genstartes med ét klik.

Har du aldrig lagt en Node-app på et webhotel før, er det startfilen, alle går i stå ved — Passenger skal bruge ét startscript, der starter dit framework. Vi giver dig et til hvert framework nedenfor; kopiér og indsæt, ingen ændringer nødvendige.

Det skal du have, før du starter

  • En Rivervo-hostingpakke (alle niveauer — Node.js-apps virker på alle pakker)
  • Node.js v20 eller nyere lokalt til at bygge din app
  • Den byggede app, klar til upload (det gennemgår vi for hvert framework)
  • Adgang til filhåndtering eller SFTP på din konto (begge virker)

Du har ikke brug for root, sudo, systemd eller opsætning af reverse proxy. Det klarer Passenger.

Trin 1 — byg din app lokalt

Du skal uploade en bygget app, ikke kildekoden. Panelet installerer afhængigheder, men det kompilerer ikke React og kører ikke et Vite-build. Det gør du først på din egen maskine.

Next.js:

npm ci
npm run build

Det giver .next/ (det byggede output). Kør ikke next start her — vi starter den fra startfilen om lidt.

Nuxt 3:

npm ci
npm run build

Det giver .output/ (Nuxts universelle build-mappe). Samme princip — kør ikke noget endnu.

Trin 2 — upload de rigtige filer

Du behøver ikke uploade node_modules/. Panelet installerer afhængighederne for dig. Du har heller ikke brug for git eller build-cache.

Upload til din konto, helst til en sti uden for public_html (f.eks. /home/<konto>/myapp/). Hvorfor uden for? Fordi Passenger automatisk monterer public_html i adressens rod, og lægger du din appkode der, bliver den eksponeret.

FrameworkUpload disseSpring over
Next.js.next/, public/, package.json, package-lock.json, next.config.js, din server.cjs (nedenfor)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, din server.cjs (nedenfor)node_modules/, .nuxt/, .git/, kildemapperne pages/, components/

To måder at få filerne derop på:

  • Hjemmeside → Filer → upload en zip → pak den ud er nemmest, hvis din forbindelse er ustabil.
  • SFTP (FileZilla, Cyberduck, rsync) er hurtigere ved gentagne udrulninger. Server, port, bruger og adgangskode står under Hjemmeside → SSH og SFTP.

Trin 3 — tilføj startfilen

Det er den fil, Passenger kører, når der kommer en forespørgsel. Læg den ved siden af package.json i din app-mappe.

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

Hvad den gør:

  • Indlæser Next og peger den på den aktuelle mappe (hvor din .next/ og package.json ligger).
  • Bygger en request handler ud fra Nexts interne router.
  • Starter en HTTP-server på den port, Passenger tildeler (process.env.PORT).
  • Falder tilbage til 3000 ved lokal test.

dev udledes automatisk af NODE_ENV — vælg tilstanden Production i panelet (det gør vi i trin 4), så kører Next i produktionstilstand.

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

Hvad den gør:

  • Importerer dynamisk Nuxts .output/server/index.mjs (startpunktet, som npm run build laver).
  • Bruger createApp() til at bygge H3-serverinstansen.
  • Lytter på den port, Passenger tildeler.

Den dynamiske import() er med vilje — .mjs-moduler kan ikke hentes med require(), men en .cjs-fil kan importere dem dynamisk. Det er det reneste mønster, der virker i Passengers launcher.

Trin 4 — opret applikationen i panelet

Åbn dit projekt → Hjemmeside → Node.js og Python → Node.js-applikation.

FeltVærdi
Version20 eller nyere
TilstandProduction
Mappemyapp i din hjemmemappe (hvor du uploadede filerne)
Adresseditdomaene.dk (eller et subdomæne som app.ditdomaene.dk)
Startfilserver.cjs

Klik Opret. Der oprettes et Node.js-miljø under ~/nodevenv/myapp/20/.

Installér afhængigheder

Når appen er oprettet, klikker du Installér afhængigheder (npm install) på den og følger outputtet. Hvis det fejler:

  • Tjek, at package.json ligger i applikationens rod (ikke i en undermappe).
  • For Next.js: tjek, at next står under dependencies, ikke devDependencies (produktionsinstallation springer udviklingsafhængigheder over).
  • For Nuxt: nuxt selv skal også være en almindelig afhængighed.

Tilføj miljøvariabler

Appens Indstillinger → Miljøvariabler → Tilføj en variabel. Tilstanden Production sætter allerede NODE_ENV=production.

Til Next.js-apps, der læser værdier ved kørsel (database-URL'er, API-nøgler), tilføjer du dem her. Læg aldrig en .env-fil med hemmeligheder op — appens miljøvariabler er det rette sted.

Når du gemmer indstillingerne, genstarter appen, så de nye variabler gælder med det samme.

Trin 5 — tjek resultatet

Gå ind på din applikations adresse. Du skulle gerne se din app.

Ser du en fejlside fra Passenger, så fold den ud og kig nederst — der er næsten altid en tydelig stack trace. De to mest almindelige:

Error: Cannot find module 'next' — npm install kørte ikke, eller den kørte i den forkerte mappe. Klik Installér afhængigheder (npm install) igen.

Error: ENOENT: no such file or directory, open '.next/...' — du uploadede kildekoden, men ikke den byggede .next/-mappe. Byg lokalt, og upload igen.

Sådan udruller du opdateringer

Gentag trin 1 og 2, og klik Genstart på appen. Konkret:

1. Byg lokalt       npm run build
2. Upload          .next/ eller .output/ plus ændrede kilde-/konfigurationsfiler
3. Panel          Genstart appen

Ændrer du package.json, så klik Installér afhængigheder (npm install), før du genstarter. Foretrækker du kommandolinjen? Hjemmeside → Terminal: appens kort viser kommandoen til at gå ind i dens miljø.

Typiske faldgruber

WebSockets: Passenger håndterer HTTP/1.1 og HTTP/2. WebSocket-upgrade virker for Next.js' og Nuxts indbyggede ruter. Bruger du en separat WebSocket-server (ws, socket.io), deler den samme port og starter via den samme server.cjs — ingen ekstra opsætning.

Filupload / body-parser-grænser i next.config.js: Passengers standardgrænse for en forespørgsels indhold er 10 MB. Uploader du store filer, så sæt passenger_max_request_size højere via .htaccess i public_html:

PassengerMaxRequestSize 52428800

(50 MB i bytes.)

Cronjobs: har din app brug for baggrundsopgaver (udsendelse af nyhedsbreve, planlagte eksporter), så kør dem ikke i webprocessen. Brug Hjemmeside → Cronjobs til at køre et Node-script direkte:

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

Proceshukommelse: Passenger genstarter din app, hvis den overskrider kontoens RAM-loft (afhænger af din pakke). En typisk Next.js-/Nuxt-app bruger under 100 MB i tomgang. Rammer du loftet, så profilér med process.memoryUsage(), og led efter lækager, før du går ud fra, at du har brug for en større pakke.

Egne domæner og HTTPS: den adresse, du sætter for appen, er den, Passenger binder til. SSL er automatisk — ingen ekstra opsætning. Til et andet domæne eller et subdomæne tilføjer du det først under Hjemmeside → Domæner og vælger det så som appens adresse.

Node-version: listen Version viser alle installerede versioner; skift den i appens Indstillinger.

Hvornår du ikke skal bruge et webhotel til Node

Helt ærligt — Node.js på et webhotel fungerer glimrende til porteføljer, blogs, markedsføringssider, små SaaS-frontends og interne værktøjer. Det har det svært med:

  • API'er med høj belastning (>50 forespørgsler/sek. vedvarende) — du mærker kontoens CPU-loft
  • Apps med mange WebSockets og tusindvis af samtidige forbindelser
  • Apps, der starter workerprocesser (køworkere, scrapere) — Passengers procesbudget pr. konto gør det besværligt
  • Alt, der kræver systemd, Docker eller root-adgang

Til det er vores VPS det rigtige valg — fuld root, din egen kerne, kører hvad du vil. Men for de fleste Next.js- og Nuxt-apps uden enorm trafik er denne guide alt, hvad du behøver.

Kort fortalt

  1. npm run build lokalt
  2. Upload .next/ (Next) eller .output/ (Nuxt) + package.json + server.cjs
  3. Hjemmeside → Node.js og Python → Node.js-applikation → mappen, startfil server.cjs, tilstand Production
  4. Installér afhængigheder (npm install), derefter Genstart

Driller noget, så opret en sag — indsæt Passengers fejlside, så peger vi på linjen.

— Rivervo-teamet