Kom i gang
Alle innleggVEILEDNING · 7 MIN LESING

Rull ut Node.js-appen din på Rivervo-hosting (Next.js og Nuxt).

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

Mange tror Node.js-apper må ligge på en VPS. Det må de ikke – alle Rivervo-pakker for webhotell har Node.js og Python i nettsidemenyen, som starter en Phusion Passenger-prosess for appen din bak den samme Apache-fronten som betjener de andre nettsidene dine.

Denne guiden går gjennom hele løpet for de to vanligste rammeverkene: Next.js og Nuxt 3. Sluttresultatet: appen din på https://dittdomene.no (eller et hvilket som helst underdomene), som kjører i en ekte Node.js-prosess, overlever omstarter og kan startes på nytt med ett klikk.

Har du aldri rullet ut en Node-app på et webhotell før, er det oppstartsfilen alle blir sittende fast på – Passenger trenger ett enkelt startskript som starter rammeverket ditt. Vi gir deg ett for hvert rammeverk nedenfor; kopier og lim inn, ingen endringer nødvendig.

Dette trenger du før du begynner

  • En Rivervo-hostingpakke (hvilken som helst – Node.js-apper fungerer på alle pakker)
  • Node.js v20 eller nyere lokalt for å bygge appen
  • Den ferdigbygde appen, klar til opplasting (vi går gjennom dette for hvert rammeverk)
  • Tilgang via filbehandleren eller SFTP til kontoen din (begge fungerer)

Du trenger ikke root, sudo, systemd eller oppsett av omvendt proxy. Passenger tar seg av alt det.

Steg 1 – bygg appen lokalt

Du skal laste opp en ferdigbygd app, ikke kildekoden. Panelet installerer avhengigheter, men det kompilerer ikke React eller kjører en Vite-bygging. Gjør det på din egen maskin først.

Next.js:

npm ci
npm run build

Det lager .next/ (det ferdigbygde resultatet). Ikke kjør next start her – vi starter den fra oppstartsfilen om et øyeblikk.

Nuxt 3:

npm ci
npm run build

Det lager .output/ (Nuxts universelle byggemappe). Samme her – ikke kjør noe ennå.

Steg 2 – last opp de riktige filene

Du trenger ikke å laste opp node_modules/. Panelet installerer avhengighetene for deg. Du trenger heller ikke git eller byggebuffere.

Last opp til kontoen din, helst til en sti utenfor public_html (f.eks. /home/<konto>/myapp/). Hvorfor utenfor? Fordi Passenger automatisk monterer public_html i roten av adressen, og ligger appkoden der, blir den eksponert.

RammeverkLast opp disseHopp 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/, kildemappene pages/, components/

To måter å få filene dit på:

  • Nettside → Filer → last opp en zip-fil → pakk den ut er enklest hvis forbindelsen er ustabil.
  • SFTP (FileZilla, Cyberduck, rsync) er raskere ved gjentatte utrullinger. Server, port, bruker og passord finner du under Nettside → SSH og SFTP.

Steg 3 – legg til oppstartsfilen

Dette er filen Passenger kjører når en forespørsel kommer inn. Legg den ved siden av package.json i appmappen.

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

Hva den gjør:

  • Laster Next og peker den mot gjeldende mappe (der .next/ og package.json ligger).
  • Lager en forespørselshåndterer fra Nexts interne ruter.
  • Starter en HTTP-server på porten Passenger tildeler (process.env.PORT).
  • Faller tilbake til 3000 ved lokal testing.

dev utledes automatisk fra NODE_ENV – velg modusen Produksjon i panelet (det gjør vi i steg 4), så kjører Next i produksjonsmodus.

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

Hva den gjør:

  • Importerer Nuxts .output/server/index.mjs dynamisk (startpunktet som npm run build lager).
  • Bruker createApp() til å bygge H3-serverinstansen.
  • Lytter på porten Passenger tildeler.

Den dynamiske import() er med vilje – .mjs-moduler kan ikke lastes med require(), men en .cjs-fil kan importere dem dynamisk. Dette er det ryddigste mønsteret som fungerer i Passengers oppstarter.

Steg 4 – opprett applikasjonen i panelet

Åpne prosjektet ditt → Nettside → Node.js og Python → Node.js-applikasjon.

FeltVerdi
Versjon20 eller nyere
ModusProduksjon
Mappemyapp i hjemmemappen din (der du lastet opp filene)
Adressedittdomene.no (eller et underdomene som app.dittdomene.no)
Startfilserver.cjs

Klikk Opprett. Et Node.js-miljø blir laget under ~/nodevenv/myapp/20/.

Installer avhengigheter

Når appen er opprettet, klikker du Installer avhengigheter (npm install) på den og følger med på utdataene. Hvis det mislykkes:

  • Sjekk at package.json ligger i roten av applikasjonen (ikke i en undermappe).
  • For Next.js: bekreft at next står under dependencies, ikke devDependencies (produksjonsinstallasjon hopper over utviklingsavhengigheter).
  • For Nuxt: nuxt selv skal også være en vanlig avhengighet.

Legg til miljøvariabler

Appens Innstillinger → Miljøvariabler → Legg til en variabel. Modusen Produksjon setter allerede NODE_ENV=production.

For Next.js-apper som leser verdier under kjøring (database-adresser, API-nøkler), legger du dem til her. Ikke send med en .env-fil med hemmeligheter – appens miljøvariabler er rett sted.

Når du lagrer innstillingene, startes appen på nytt, så de nye variablene gjelder med en gang.

Steg 5 – bekreft

Gå til adressen til applikasjonen. Du skal se appen din.

Ser du en feilside fra Passenger, åpner du den og ser nederst – der er det nesten alltid en tydelig stakksporing. De to vanligste:

Error: Cannot find module 'next' – npm install ble ikke kjørt, eller den ble kjørt i feil mappe. Klikk Installer avhengigheter (npm install) igjen.

Error: ENOENT: no such file or directory, open '.next/...' – du lastet opp kildekoden, men ikke den ferdigbygde mappen .next/. Bygg lokalt og last opp på nytt.

Slik ruller du ut oppdateringer

Gjenta steg 1 og 2, og klikk Start på nytt på appen. Konkret:

1. Bygg lokalt      npm run build
2. Last opp         .next/ eller .output/, pluss endret kildekode/oppsett
3. Panel            Start appen på nytt

Endrer du package.json, klikker du Installer avhengigheter (npm install) før du starter på nytt. Foretrekker du kommandolinjen? Nettside → Terminal: appkortet viser kommandoen for å gå inn i miljøet.

Vanlige fallgruver

WebSockets: Passenger håndterer HTTP/1.1 og HTTP/2. WebSocket-oppgradering fungerer for de innebygde rutene i Next.js og Nuxt. Bruker du en egen WebSocket-server (ws, socket.io), deler den samme port og startes via den samme server.cjs – uten ekstra oppsett.

Filopplasting / grenser for body-parser i next.config.js: Passengers standardgrense for størrelsen på forespørsler er 10 MB. Laster du opp store filer, setter du passenger_max_request_size høyere via .htaccess i public_html:

PassengerMaxRequestSize 52428800

(50 MB i byte.)

Cron-jobber: trenger appen bakgrunnsoppgaver (utsending av nyhetsbrev, planlagte eksporter), skal du ikke kjøre dem i webprosessen. Bruk Nettside → Cron-jobber til å kjøre et Node-skript direkte:

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

Prosessminne: Passenger starter appen på nytt hvis den bruker mer enn RAM-taket per konto (avhenger av pakken). En typisk Next.js- eller Nuxt-app bruker under 100 MB i hvile. Treffer du grensene, bør du profilere med process.memoryUsage() og lete etter lekkasjer før du antar at du trenger en større pakke.

Egne domener og HTTPS: adressen du setter for appen, er det Passenger binder seg til. SSL er automatisk – uten ekstra oppsett. For et annet domene eller et underdomene legger du det først til under Nettside → Domener og velger det så som adresse for appen.

Node-versjon: listen Versjon viser alle installerte versjoner; du bytter i appens Innstillinger.

Når du ikke bør bruke webhotell for Node

For å være ærlig – Node.js på webhotell fungerer utmerket for porteføljesider, blogger, markedsføringssider, små SaaS-frontender og interne verktøy. Det sliter med:

  • API-er med høy gjennomstrømning (over 50 forespørsler/sek over tid) – du vil merke CPU-taket per konto
  • Apper med mye WebSocket-trafikk og tusenvis av samtidige tilkoblinger
  • Apper som starter arbeidsprosesser (køarbeidere, skrapere) – Passengers prosessbudsjett per konto gjør dette tungvint
  • Alt som krever systemd, Docker eller root-tilgang

Til slikt er VPS-en vår riktig valg – full root, egen kjerne, kjører hva du vil. Men for de fleste Next.js- og Nuxt-apper som ikke har enorm trafikk, er denne guiden alt du trenger.

Kort oppsummert

  1. npm run build lokalt
  2. Last opp .next/ (Next) eller .output/ (Nuxt) + package.json + server.cjs
  3. Nettside → Node.js og Python → Node.js-applikasjon → mappen, startfil server.cjs, modus Produksjon
  4. Installer avhengigheter (npm install), deretter Start på nytt

Oppfører noe seg rart, oppretter du en sak – lim inn feilsiden fra Passenger, så peker vi deg til riktig linje.

– Rivervo-teamet