Fazer deploy
docs

FAQ

Perguntas frequentes sobre a Veloz.

Perguntas frequentes sobre a plataforma Veloz.

Geral

O que é a Veloz?

A Veloz é uma plataforma brasileira de deploy para produção. Você conecta seu repositório, a Veloz detecta o framework e faz deploy automaticamente em servidores no Brasil, com banco gerenciado, TLS, backups e suporte 24/7.

A Veloz serve para produção?

Sim. Rodar apps de produção é o uso principal da plataforma: APIs, SaaS com clientes pagantes e apps com milhares de usuários. SLA de 99,9% no Pro com créditos, backups contínuos com recuperação pontual (PITR), réplica com failover automático, autoscaling, health checks, rollback em um clique e suporte 24/7 com escalação automática para humanos. Veja Veloz em produção.

A Veloz funciona com agentes de IA?

Sim, foi feita para isso. A CLI é também um servidor MCP: Claude Code, Cursor, Windsurf, Codex e qualquer cliente MCP fazem deploy, criam bancos, leem logs, ajustam variáveis e abrem chamados de suporte sem o desenvolvedor sair do chat. Veja Deploy com IA.

Quais frameworks são suportados?

A CLI detecta automaticamente:

  • Frontend: Next.js, Nuxt, Remix, SvelteKit, Astro, Gatsby, Angular, Vite, Create React App
  • Backend: Express, Fastify, Hono, NestJS, Node.js genérico
  • Monorepo: pnpm workspaces, npm workspaces
  • Outras linguagens: Python (Django, FastAPI), Go, Rust, Java, Ruby (Rails), PHP (Laravel), Elixir (Phoenix), .NET e Deno

Se o seu framework não for detectado, a Veloz tenta buildar automaticamente a partir do package.json. Você também pode configurar os comandos de build e start manualmente.

Onde ficam os servidores?

Em São Paulo, Brasil. Bancos de dados, volumes e cópias de segurança ficam no Brasil. Apps no runtime Workers rodam na rede global da Cloudflare, e alguns dados ficam nos Estados Unidos. Veja Subprocessadores.

Preciso saber Docker?

Não. A Veloz detecta seu framework e configura tudo automaticamente. Se você já tem um Dockerfile, a Veloz usa ele. Se não, gera um automaticamente.

A Veloz suporta monorepos?

Sim. A CLI detecta monorepos automaticamente (pnpm workspaces, npm workspaces) e permite fazer deploy de múltiplos apps em paralelo. Veja Monorepo.

Deploy

Como faço meu primeiro deploy?

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

Quanto tempo leva um deploy?

Depende do tamanho do projeto e das dependências. A maioria dos deploys completa em 1 a 5 minutos.

Posso fazer deploy via CI/CD?

Sim. Crie uma API key com veloz apikey create e use no seu pipeline com a flag --yes:

VELOZ_API_KEY=vlz_xxx veloz deploy --yes

Veja CI/CD para exemplos com GitHub Actions, GitLab CI e Bitbucket.

Meu app tem SSL automaticamente?

Sim. Todos os apps recebem certificado SSL automaticamente, tanto para domínios .onveloz.com quanto para domínios personalizados.

Variáveis de Ambiente

Como defino variáveis de ambiente?

veloz env set DATABASE_URL=postgres://...
veloz env set KEY1=val1 KEY2=val2

Também pode importar de um arquivo .env:

veloz env import .env

As variáveis são seguras?

Sim. Variáveis são mascaradas na CLI e no dashboard. Nunca aparecem nos logs de build.

Domínios

Como adiciono um domínio personalizado?

veloz domains add meuapp.com

A CLI vai exibir as instruções de DNS (CNAME). Após configurar, verifique:

veloz domains verify <domainId>

Preciso configurar SSL para meu domínio?

Não. O certificado SSL é provisionado automaticamente após a verificação do DNS.

Preços

Quanto custa?

O plano Vibe é gratuito, com R$5 de uso por mês, sem cartão. O plano Pro é o plano de produção: projetos e serviços ilimitados, até 32 GB por serviço, autoscaling e logs por 30 dias. Preços em real, cobrança por uso: Pro custa R$49/mês, serviços de R$5 (0,1 vCPU, 256 MB) a R$170/mês (4 vCPU, 8 GB) por instância, bancos gerenciados de R$6 a R$195/mês e volumes a R$0,50 por GB/mês. Veja Preços.

Suporte

Como consigo ajuda?

O suporte funciona 24/7. Chamados são atendidos por agentes de IA da Veloz a qualquer hora, e incidentes urgentes (serviço fora do ar, dados, segurança) escalam automaticamente para a equipe humana por alerta. Cada chamado é atendido em uma VM isolada, com acesso somente aos recursos da sua organização. Abra um chamado pelo dashboard, por veloz support create ou pelo seu agente com a ferramenta MCP support_create. Veja Suporte.

Para comunidade e dúvidas rápidas: Discord ou contato@onveloz.com.

Próximos passos