Fazer Deploy de um App Next.js

Última atualização em 18 de abril de 2025

Você pode encontrar o guia passo a passo para fazer deploy aqui.

Configuração do ambiente de build
Copiar link

Ao fazer deploy de um projeto Next.js, o ambiente de build executa os seguintes comandos por padrão:

DEBIAN_FRONTEND=noninteractive apt-get update && apt-get install -y --no-install-recommends \
  curl \
  {% if system_dependencies %}{{ system_dependencies | join(' ') }}{% endif %} \
  && rm -rf /var/lib/apt/lists/*

Aqui, system_dependencies se refere aos pacotes do sistema configurados no painel de controle.

Em seguida, as dependências do projeto são instaladas usando o gerenciador de pacotes detectado no repositório (yarn, pnpm ou npm):

yarn install
pnpm install
npm install

Suporte a SSR
Copiar link

Ao criar uma aplicação, é possível habilitar o suporte a SSR.

Nesse caso, a aplicação será executada como uma aplicação backend:

  • Será necessário selecionar uma configuração de servidor.
  • A interface do painel de controle após o deploy será idêntica à de uma aplicação backend.
  • Será possível definir um comando de inicialização. O comando padrão é:
npm start

O suporte a SSR não pode ser desativado após o deploy. Para alterar o modo da aplicação, será necessário criar uma nova aplicação com a configuração desejada.