Quali opzioni di deployment e output di build supporta Next.js?

Question

Accepted Answer

Next.js supporta diversi target di deployment, controllati in parte dalla configurazione **`output`**. La scelta giusta dipende dal fatto che tu abbia bisogno del server Node, dei container o dell'hosting statico puro.

## Le modalità di build output

```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 (server Node) — funzionalità complete

Esegue un server Node.js, quindi ottieni **tutto**: SSR, ISR, Server Actions, Route Handlers, ottimizzazione delle immagini, middleware. Questo è quello che usano piattaforme come **Vercel** (il creatore di Next.js, zero-config) e gli host Node.

## 2. output: "standalone" — per 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` produce una cartella minimale con solo le dipendenze effettivamente utilizzate, ideale per piccole immagini Docker su AWS, GCP, i tuoi server, ecc. Mantieni tutte le funzionalità del server.

## 3. output: "export" — completamente statico

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

L'esportazione statica offre l'hosting più economico e semplice ma **disabilita le funzionalità del server**: nessun SSR, nessun ISR, nessun Route Handler, nessun Server Actions, nessuna ottimizzazione delle immagini al volo. Adatto solo per siti completamente statici.

## Scelta

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

## Altre considerazioni

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

## Perché è importante

Il deployment non è una soluzione universale: la modalità `output` determina quali funzionalità di Next.js sopravvivono.

Sapere che l'output **default/Node** mantiene tutte le capacità del server, **standalone** le confeziona per Docker/self-hosting, e **export** scambia tutte le funzionalità del server per l'hosting statico puro ti permette di abbinare la build alla tua infrastruttura — e di evitare la trappola di `output: "export"` che rompe silenziosamente SSR/ISR/Server Actions.