Como hospedar uma aplicação Next.js na Vertra Cloud

Requisitos

Node.js 18+ instalado localmente
Conta na Vertra Cloud

Estrutura do projeto

my-app-next/
├── src/
│   ├── app/
│   │   ├── layout.tsx
│   │   └── page.tsx
│   └── components/
├── public/
├── next.config.js
├── package.json
└── vertracloud.config

Configuração

next.config.js

Para o deploy na Vertra Cloud, configure o modo standalone para otimizar o tamanho do build:

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'standalone',
};

module.exports = nextConfig;

package.json

{
  "name": "my-app-next",
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start -p 80"
  },
  "dependencies": {
    "next": "^14.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

vertracloud.config

MAIN=package.json
BUILD=npm run build
START=npx next start -p 80
VERSION=recommended

O Next.js precisa ser compilado antes de iniciar. Defina o build_command como npm run build (ou a chave BUILD acima), em vez de encadeá-lo ao comando de start — ele roda em um ambiente de build isolado (2× a RAM e a vCPU da aplicação, timeout de 10 minutos) a cada deploy, e um restart simples o pula quando o último build já teve sucesso.

Versões disponíveis

Versão	Status	Descrição
24.22.1	Mais recente	Node.js 24.22.1 (versão mais recente)
22.23.4	Recomendada	Node.js 22.23.4 LTS (recomendada para produção)

Deploy

Dashboard
CLI
VS Code

Compacte o projeto em um .zip (pastas como node_modules, venv e target são removidas automaticamente) ou envie-o ao GitHub.
No dashboard, clique em Novo Projeto e envie o .zip ou cole a URL do repositório.
Em Build, confira o runtime (JavaScript ou TypeScript) e a memória. Em Configurações avançadas, confirme o comando de build npm run build e o comando de start npx next start -p 80; ambos já vêm preenchidos para projetos Next.js.
Adicione suas variáveis de ambiente em Variáveis de Ambiente.
Em Rede, ative a publicação na web para que a aplicação receba um endereço *.vertraweb.app (plano Pro ou superior, 512 MB de memória). A aplicação precisa escutar na porta 80.
Revise e faça o deploy. Acompanhe a saída na aba Logs.

vertra upload
vertra logs -f

Veja a CLI para instalação e login.

O passo a passo completo está em Primeiro deploy.

Observações

Memória recomendada: 512 MB ou mais (o processo de build é intensivo)
Variáveis de ambiente: configure pelo dashboard antes do primeiro build
Use output: 'standalone' para reduzir o tamanho do build
As API Routes do Next.js funcionam normalmente na plataforma
A aplicação precisa escutar na porta 80

Problemas comuns

O build falha por falta de memória

O ambiente de build já recebe 2× a RAM da aplicação automaticamente. Se ainda assim falhar, aumente a memória da própria aplicação para pelo menos 512 MB — o ambiente de build escala com ela.

O build excede o limite de tempo

O build_command tem um teto de 10 minutos (BUILD_TIMEOUT). Reduza as dependências ou divida um build muito grande.

A página retorna 404

Verifique se o output: 'standalone' está configurado e se o build terminou com sucesso nos logs.

Visão geral

Bots

Node.js

Python

Outras linguagens

Como hospedar uma aplicação Next.js na Vertra Cloud

Requisitos

Estrutura do projeto

Configuração

next.config.js

package.json

vertracloud.config

Versões disponíveis

Deploy

Observações

Problemas comuns

​Requisitos

​Estrutura do projeto

​Configuração

​next.config.js

​package.json

​vertracloud.config

​Versões disponíveis

​Deploy

​Observações

​Problemas comuns

Requisitos

Estrutura do projeto

Configuração

next.config.js

package.json

vertracloud.config

Versões disponíveis

Deploy

Observações

Problemas comuns