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 buildDet giver .next/ (det byggede output). Kør ikke next start her — vi starter den fra startfilen om lidt.
Nuxt 3:
npm ci
npm run buildDet 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.
| Framework | Upload disse | Spring 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/ogpackage.jsonligger). - Bygger en request handler ud fra Nexts interne router.
- Starter en HTTP-server på den port, Passenger tildeler (
process.env.PORT). - Falder tilbage til
3000ved 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, somnpm run buildlaver). - 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.
| Felt | Værdi |
|---|---|
| Version | 20 eller nyere |
| Tilstand | Production |
| Mappe | myapp i din hjemmemappe (hvor du uploadede filerne) |
| Adresse | ditdomaene.dk (eller et subdomæne som app.ditdomaene.dk) |
| Startfil | server.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.jsonligger i applikationens rod (ikke i en undermappe). - For Next.js: tjek, at
nextstår underdependencies, ikkedevDependencies(produktionsinstallation springer udviklingsafhængigheder over). - For Nuxt:
nuxtselv 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.jsProceshukommelse: 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
npm run buildlokalt- Upload
.next/(Next) eller.output/(Nuxt) +package.json+server.cjs - Hjemmeside → Node.js og Python → Node.js-applikation → mappen, startfil
server.cjs, tilstand Production - 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