Welke deployment opties en build outputs ondersteunt Next.js?

Question

Accepted Answer

Next.js ondersteunt verschillende deployment targets, gedeeltelijk bepaald door de **`output`** configuratie. De juiste keuze hangt af van of je een Node server, containers of zuiver statisch hosten nodig hebt.

## De build output modes

```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. Default (Node server) — volledige functies

Voert een Node.js server uit, dus je krijgt **alles**: SSR, ISR, Server Actions, Route Handlers, image optimization, middleware. Dit is wat platforms zoals **Vercel** (de maker van Next.js, zero-config) en Node hosts gebruiken.

## 2. output: "standalone" — voor Docker / self-hosting

```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` levert een minimale folder met alleen de daadwerkelijk gebruikte dependencies, ideaal voor kleine Docker images op AWS, GCP, je eigen servers, enz. Je houdt alle server functies.

## 3. output: "export" — volledig statisch

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

Statische export geeft het goedkoopste, eenvoudigste hosten maar **schakelt server functies uit**: geen SSR, geen ISR, geen Route Handlers, geen Server Actions, geen on-the-fly image optimization. Alleen geschikt voor volledig statische sites.

## Kiezen

```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
```

## Andere overwegingen

```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
```

## Waarom het belangrijk is

Implementatie is niet één maat voor alles: de `output` mode bepaalt welke Next.js functies behouden blijven.

Weten dat de **default/Node** output alle server mogelijkheden behoudt, **standalone** deze inpakt voor Docker/self-hosting, en **export** alle server functies inruilt voor zuiver statisch hosten, stelt je in staat om de build af te stemmen op je infrastructuur — en voorkomt de valkuil dat `output: "export"` SSR/ISR/Server Actions stilzwijgend breekt.