Saltar al contenido principal

Requisitos

Estructura del proyecto

Configuración

next.config.js

Para desplegar en Vertra Cloud, configura el modo standalone para optimizar el tamaño del build:

package.json

vertracloud.config

Next.js necesita compilarse antes de iniciarse. Define build_command como npm run build (o la clave BUILD de arriba) en lugar de encadenarlo al comando de inicio: se ejecuta en su propio entorno de build aislado (2× la RAM y la vCPU de la aplicación, con un timeout de 10 minutos) en cada despliegue, y un reinicio normal lo omite cuando el último build ya terminó correctamente.

Versiones disponibles

Deploy

  1. Comprime el proyecto en un .zip (las carpetas como node_modules, venv y target se eliminan automáticamente) o súbelo a GitHub.
  2. En el panel, haz clic en Nuevo Proyecto y sube el .zip o pega la URL del repositorio.
  3. En Build, revisa el runtime (JavaScript o TypeScript) y la memoria. En Ajustes avanzados, confirma el comando de build npm run build y el comando de inicio npx next start -p 80; ambos vienen rellenados en los proyectos de Next.js.
  4. Añade tus variables de entorno en Variables de Entorno.
  5. En Red, activa la publicación web para que la aplicación reciba una dirección *.vertraweb.app (plan Pro o superior, 512 MB de memoria). La aplicación debe escuchar en el puerto 80.
  6. Revisa y despliega. Sigue la salida en la pestaña Logs.
La guía completa está en Primer despliegue.

Notas

  • Memoria recomendada: 512 MB o más (el proceso de build es intensivo)
  • Variables de entorno: configúralas desde el panel antes del primer build
  • Usa output: 'standalone' para reducir el tamaño del build
  • Las API Routes de Next.js funcionan con normalidad en la plataforma
  • La aplicación debe escuchar en el puerto 80

Problemas comunes

El entorno de build ya recibe automáticamente 2× la RAM de la aplicación. Si aun así falla, sube la memoria de la propia aplicación a al menos 512 MB: el entorno de build escala con ella.
build_command tiene un límite de 10 minutos (BUILD_TIMEOUT). Reduce las dependencias o divide un build muy grande.
Comprueba si output: 'standalone' está configurado y si el build terminó correctamente según los logs.
Última modificación el 26 de octubre de 2026