Hvilke deployment-muligheder og build-output understøtter Next.js?

Question

Accepted Answer

Next.js understøtter flere deployment-mål, delvist kontrolleret af **`output`**-konfigurationen. Det rigtige valg afhænger af, om du har brug for Node-serveren, containere eller ren statisk hosting.

## Build output-tilstande

```js
// next.config.js
module.exports = {
  // output: undefined  → default: needs a Node.js server (full features)
  // output: "standalone" → self-contained folder for Docker/containers
  // output: "export"     → pure static HTML/CSS/JS (no server)
};
```

## 1. Standard (Node-server) — fuld funktionalitet

Kører en Node.js-server, så du får **alt**: SSR, ISR, Server Actions, Route Handlers, billedoptimering, middleware. Dette er hvad platforme som **Vercel** (skaberen af Next.js, nul-konfiguration) og Node-værter bruger.

## 2. output: "standalone" — til Docker / selvhosting

```dockerfile
# Next traces only the needed files into .next/standalone → a tiny, self-contained server
COPY --from=builder /app/.next/standalone ./
CMD ["node", "server.js"]
```

`standalone` producerer en minimal mappe med kun de afhængigheder, der faktisk bruges, ideel til små Docker-billeder på AWS, GCP, dine egne servere osv. Du beholder alle serveregenskaber.

## 3. output: "export" — fuldt statisk

```text
next build → out/  (plain HTML/CSS/JS, deployable to any static host: S3, GitHub Pages, Netlify CDN)
```

Statisk eksport giver den billigste, enkleste hosting, men **deaktiverer serveregenskaber**: ingen SSR, ingen ISR, ingen Route Handlers, ingen Server Actions, ingen billedoptimering på farten. Kun egnet til helt statiske websteder.

## Valg

```text
Need SSR/ISR/Server Actions, want zero-config → Vercel (or a Node host) — default output
Want containers / self-host with full features → output: "standalone" + Docker
Purely static content (docs, marketing)        → output: "export" → any static CDN
```

## Andre overvejelser

```text
- Runtime choice (Edge vs Node) affects where functions run
- Self-hosting ISR/caching needs persistent storage or a shared cache
- Image optimization on non-Vercel hosts may need a custom loader
```

## Hvorfor det betyder noget

Deployment er ikke en universal løsning: `output`-tilstanden bestemmer, hvilke Next.js-funktioner der overlever.

At vide, at **standard/Node**-output bevarer alle serveregenskaber, **standalone** pakker dem til Docker/selvhosting, og **export** handler alle serveregenskaber for ren statisk hosting lader dig matche buildet med din infrastruktur — og undgå falden i `output: "export"`, der stiltiende bryder SSR/ISR/Server Actions.