Rull ut Node.js-appen din på Rivervo-hosting (Next.js og Nuxt).
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 buildDet 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 buildDet 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.
| Rammeverk | Last opp disse | Hopp 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/ogpackage.jsonligger). - Lager en forespørselshåndterer fra Nexts interne ruter.
- Starter en HTTP-server på porten Passenger tildeler (
process.env.PORT). - Faller tilbake til
3000ved 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.mjsdynamisk (startpunktet somnpm run buildlager). - 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.
| Felt | Verdi |
|---|---|
| Versjon | 20 eller nyere |
| Modus | Produksjon |
| Mappe | myapp i hjemmemappen din (der du lastet opp filene) |
| Adresse | dittdomene.no (eller et underdomene som app.dittdomene.no) |
| Startfil | server.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.jsonligger i roten av applikasjonen (ikke i en undermappe). - For Next.js: bekreft at
nextstår underdependencies, ikkedevDependencies(produksjonsinstallasjon hopper over utviklingsavhengigheter). - For Nuxt:
nuxtselv 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å nyttEndrer 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.jsProsessminne: 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
npm run buildlokalt- Last opp
.next/(Next) eller.output/(Nuxt) +package.json+server.cjs - Nettside → Node.js og Python → Node.js-applikasjon → mappen, startfil
server.cjs, modus Produksjon - 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