La respuesta corta

Para desplegar una app Next.js como servidor, usá next build y después next start. No uses next dev. Tratá NEXT_PUBLIC_ como público y fijo en ese build. Revisá la memoria del build y qué no comparten las réplicas antes de escalar.

La receta Next.js en Unbroker requiere Pro, con memoria suficiente para el build y para el servidor en marcha. La guía no publica un número para esa memoria. Los pasos están en desplegar Next.js y en Deploy a Next.js application.

Servidor o export estático

Elegí el preset Next.js cuando la app necesita un servidor. Un export estático es otra forma. Next.js lo prende con output: 'export' en next.config.js. next build escribe entonces una carpeta out de HTML, CSS y JavaScript.

Ese export no da features que necesitan un servidor en el request. Next.js lista cookies, server actions, regeneración estática incremental, redirects y route handlers que leen el request entre lo que no soporta. Un route handler en un export puede emitir un GET estático solo si lo marcás dynamic = 'force-static'. La fuente es Next.js static exports.

La guía de Unbroker dice el mismo corte: un export estático produce archivos y no puede dar features de servidor en el request. Esta nota no describe una receta Free aparte para un export de Next.js. Free incluye HTML estático y sitios estáticos de React, Vue, Vite y Astro, más Node.js gestionado. Otras recetas de framework, incluida la de Next.js, son Pro. El preset de Astro sirve los archivos generados, y un adaptador de servidor es otro deploy. Esa decisión está en hosting para Astro.

Los scripts que importan

Los scripts de producción de la guía son:

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start --hostname 0.0.0.0"
  }
}

next build crea el build de producción. next start lo corre. next dev es el servidor de desarrollo. Un next sin comando es un alias de next dev, así que no es un arranque de producción. La referencia es la CLI de Next.js.

next start lee PORT. El puerto default de la CLI es 3000, y -p o --port lo pisan. Next.js dice que PORT no se puede poner en .env, porque el servidor HTTP arranca antes de leer ese archivo. Una variable de plataforma llamada PORT no es ese archivo.

La CLI lista --hostname con default 0.0.0.0 para next start. El script de ejemplo de Unbroker pasa el flag igual. Si usás standalone output o un servidor propio, ajustá el comando de arranque a esa salida. La guía no nombra un comando de reemplazo.

Corré el install con lockfile, el build y el start en local. Probá una ruta dinámica además de la home.

Variables públicas de build y secretos de runtime

NEXT_PUBLIC_ es para el código del navegador. Tratalo como público. Unbroker elige las variables públicas de build, incluidas NEXT_PUBLIC_* y VITE_*, para el entorno de destino antes del build. Un cambio que ya está en el frontend pide un build nuevo. Cómo funcionan los alcances está en Variables de entorno y secretos.

Las variables privadas quedan solo en runtime, salvo las credenciales de registro de paquetes que la documentación nombra. No hagas que la generación estática dependa de un secreto de producción que falta durante el build. Mové ese trabajo al request, o usá un proceso de build pensado para eso.

Las variables son All, Production o Preview. Un preview nuevo copia All y Preview, no los valores que son solo de Production. Redesplegá después de un cambio de runtime para que la revisión en marcha lo tome.

Cuando el build se queda sin memoria

Mirá dónde falló el build: instalación de dependencias, compilación o generación de páginas. Bajá trabajo que el build no necesita, o cambiá la capacidad de esa etapa. Réplicas extra de runtime no arreglan un build que ya se quedó sin memoria.

La documentación no publica un umbral de memoria para esa falla. La receta igual pide memoria suficiente para el build y para el runtime. Si el proceso ya está corriendo y después falla, es otra etapa. Cómo leer el log correcto está en Depurar un deploy fallido.

Más de una réplica

Las réplicas no comparten la memoria del proceso ni los archivos locales. Revisá sesiones, cachés, archivos subidos y estado generado antes de sumar una réplica. Poné los datos que tienen que coincidir en una base u otro almacén compartido.

Un servicio con volumen persistente se queda en una réplica. El volumen puede crecer hasta 50 GB y no puede achicarse. Borrar el servicio borra el volumen. Ese límite está en volúmenes persistentes. Cómo cambia la cantidad de réplicas está en Autoscaling de réplicas. Los servicios Free corren una réplica. Las réplicas configurables son Pro.

Probá más que la home

Abrí la URL que te da Cloud. Probá una página renderizada en el servidor, una ruta de API si tenés una, los callbacks de autenticación y los assets estáticos. Actualizá las allowlists de callback con el origen desplegado. Una home que se ve bien no ejercita toda la app.

Un dominio propio es otro paso, distinto de la primera URL. El DNS y el certificado están en Dominio propio y HTTPS. Qué push produjo la revisión está en Desplegar con git push.

Cómo funciona en Unbroker

Creá un servicio de repositorio, elegí Next.js, y revisá la rama, el comando de build y el comando de start. Cargá las variables públicas antes del build. Agregá las credenciales privadas en Variables.

La receta Next.js requiere Pro. Pro sale $25 por mes con $25 de crédito de uso. El crédito no se acumula. Si el uso queda por debajo del crédito, el cargo sigue siendo $25. El clúster, el volumen y el build van aparte de esa cuota. Las filas están en precios y en Plans.

Un frontend y una API en el mismo proyecto están en frontend y API. Una app que arrancó en otra herramienta y sigue apuntando a la base de esa herramienta está en una app hecha con IA en producción.

Lista de control

  1. Dejá build en next build y start en next start, no en next dev.
  2. Pasá --hostname 0.0.0.0 como el script de la guía, aunque el default actual de la CLI sea el mismo host.
  3. Dejá que la plataforma entregue PORT. No dependas de PORT adentro de .env.
  4. Cargá los valores NEXT_PUBLIC_ antes del build, y reconstruí cuando cambien.
  5. Dejá los secretos de producción fuera de la generación estática.
  6. Si el build se queda sin memoria, nombrá la etapa antes de sumar réplicas de runtime.
  7. Antes de una segunda réplica, mové sesiones, cachés y uploads a un almacén compartido. Un volumen deja el servicio en una réplica.
  8. Pedí una página de servidor, una ruta de API y un callback de auth en el origen desplegado.
  9. Usá Pro para la receta Next.js. No tomes la receta Node.js de Free como este preset.

Preguntas frecuentes

¿Hay que usar next dev en producción?

No. next dev es el servidor de desarrollo, con recarga en caliente. El camino de producción es next build y después next start. La CLI de Next.js trata un next sin comando como alias de next dev. La guía de Next.js de Unbroker dice que no uses next dev como comando de arranque en producción.

¿Por qué una variable NEXT_PUBLIC_ no cambia después de editarla?

Los valores NEXT_PUBLIC_ son para el código del navegador. Unbroker elige las variables públicas de build, incluidas NEXT_PUBLIC_ y VITE_, para el entorno de destino antes del build y las incrusta en el frontend. Cambiar una pide un build nuevo. El resto queda solo en runtime, salvo las credenciales de un registro de paquetes.

¿Se puede usar un secreto durante next build?

No hagas que la generación estática dependa de un secreto de producción que no está durante el build. Unbroker deja las variables privadas solo en runtime. Mové ese trabajo al request, o usá un proceso de build pensado para eso. Un valor con el prefijo NEXT_PUBLIC_ es público aunque lo hayas escrito en Variables.

¿Por qué el build de Next.js se queda sin memoria?

Mirá en qué etapa falló: instalación de dependencias, compilación o generación de páginas. Bajá trabajo de build que no haga falta, o ajustá la capacidad de esa etapa. Réplicas extra de runtime no arreglan un build que se quedó sin memoria. La documentación no publica un número de memoria para esa falla.

¿Se puede correr Next.js en más de una réplica?

Las réplicas no comparten la memoria del proceso ni los archivos locales. Revisá sesiones, cachés, archivos subidos y estado generado antes de escalar, y poné el estado compartido en una base u otro almacén común. Un servicio con volumen persistente se queda en una réplica. La cantidad de réplicas es configurable en Pro. Los servicios Free corren una.

¿Hace falta un servidor o se puede exportar estático?

Un servidor Next.js en marcha es el preset cuando la app necesita trabajo en el request. output: 'export' escribe una carpeta out de HTML, CSS y JavaScript. Next.js no soporta cookies, server actions, regeneración estática incremental ni route handlers que leen el request en ese export. Unbroker trata el export estático como otra forma, distinta de la receta de servidor.

¿En qué puerto escucha next start?

El default de la CLI de Next.js es el puerto 3000. next start lee la variable PORT, y -p o --port la pisan. Next.js dice que PORT no se puede poner en un archivo .env, porque el servidor HTTP arranca antes de leer ese archivo. El flag de hostname tiene default 0.0.0.0. El script de ejemplo de Unbroker igual pasa --hostname 0.0.0.0.