docs
Começando

Migração

Como migrar seu app de Vercel, Railway, Render ou Heroku para a Veloz.

Vindo de outra plataforma? Migrar para a Veloz leva poucos minutos. A CLI detecta seu framework automaticamente — na maioria dos casos, basta rodar veloz deploy.

Vercel

O que muda

Vercel Veloz
CLI vercel veloz
Config vercel.json veloz.json (gerado automaticamente)
Env vars Dashboard / vercel env veloz env set / veloz env import
Domínios Dashboard / vercel domains veloz domains add
Região Global (Edge) Brasil (São Paulo)

Passo a passo

npm install -g onveloz
veloz login
cd meu-projeto
veloz deploy

Variáveis de ambiente

# Importar de um arquivo .env
veloz env import .env.production
 
# Ou definir manualmente
veloz env set DATABASE_URL=postgres://...
veloz env set NEXT_PUBLIC_API_URL=https://api.meuapp.com
 
# Múltiplas de uma vez
veloz env set KEY1=value1 KEY2=value2 KEY3=value3

Domínio

veloz domains add meuapp.com
# Atualize o DNS conforme as instruções exibidas

O que não precisa mudar

  • Next.js: Funciona identicamente — SSR, API routes, ISR
  • package.json: Nenhuma alteração necessária
  • Código: Zero mudanças

O que não existe (ainda)

  • Edge Functions (use API routes ou um serviço separado)
  • Serverless Functions (seu app roda como servidor completo — mais previsível)
  • Image Optimization (use Cloudinary, imgix ou similar)

Railway

O que muda

Railway Veloz
Deploy Git push / Dashboard veloz deploy ou Git push
Config railway.toml veloz.json
Env vars Dashboard / railway variables veloz env set / veloz env import
Domínios Dashboard veloz domains add

Passo a passo

npm install -g onveloz
veloz login
cd meu-projeto
veloz deploy

O que melhora

  • Latência no Brasil — Servidores em São Paulo
  • CLI em português — Toda a experiência é em pt-BR
  • Detecção automática — Não precisa configurar Dockerfile ou Nixpacks manualmente

Render

O que muda

Render Veloz
Deploy Git push / Dashboard veloz deploy ou Git push
Config render.yaml veloz.json
Env vars Dashboard veloz env set / veloz env import
Tipo Web Service / Static Site web / static (auto-detectado)

Passo a passo

npm install -g onveloz
veloz login
cd meu-projeto
veloz deploy

Diferenças importantes

  • Sem cold starts — Seu app está sempre rodando
  • Build rápido — Cache entre deploys, build paralelo em monorepos
  • Sem free tier sleep — Nada de esperar 30s para o app acordar

Heroku

O que muda

Heroku Veloz
CLI heroku veloz
Config Procfile veloz.json (ou auto-detect)
Env vars heroku config:set veloz env set
Scaling heroku ps:scale veloz config set --instances 3

Passo a passo

npm install -g onveloz
veloz login
cd meu-projeto
veloz deploy

Procfile → Veloz

Se você usa um Procfile, a Veloz detecta o start command automaticamente. Mas você pode ser explícito:

veloz config set --start "node server.js" --port 8080

O que melhora

  • Sem dynos dormindo — App sempre ativo
  • Servidores no Brasil — Latência muito menor para usuários brasileiros
  • Preço previsível — Sem surpresas de cobrança

Checklist de migração

Independente de qual plataforma você vem:

  • Instalar CLI: npm install -g onveloz
  • Autenticar: veloz login
  • Fazer deploy: veloz deploy
  • Configurar variáveis de ambiente: veloz env set ou veloz env import .env
  • Adicionar domínio: veloz domains add
  • Atualizar DNS (CNAME conforme instruções da Veloz)
  • Testar o app no novo domínio
  • Remover da plataforma anterior

Próximos passos