Começar

Como lançar seu primeiro aplicativo a partir do GitHub.

Conecte o GitHub, escolha um repositório, defina os recursos e um endereço e coloque tudo no ar em poucos minutos — com 3 dias de teste grátis para o seu primeiro aplicativo.

5 MIN DE LEITURA

Os Aplicativos rodam o seu próprio código — um site, uma API, uma tarefa em segundo plano — direto do seu repositório Git. Você não escolhe servidor nem plano de hospedagem: escolhe um repositório, nós descobrimos como fazer o build e executá-lo, e cada push entra no ar sozinho.

Tudo acontece no novo painel (rivervo.com/panel) → Aplicativos → Novo aplicativo.

1. Conecte sua conta Git

O GitHub está sempre disponível. Clique em Conectar o GitHub: o GitHub pergunta onde instalar a Rivervo (na sua conta pessoal ou em uma organização) e quais repositórios ela pode ler. Nada é gravado nos seus repositórios.

Já instalou a Rivervo no GitHub antes? Use Já instalou no GitHub? Vincule.

O GitLab e o Bitbucket aparecem como botões extras acima da lista de repositórios onde estão disponíveis. A conexão funciona do mesmo jeito: você permite que a Rivervo leia seus repositórios e adicione um webhook para deploys automáticos. Seu código nunca é alterado.

2. Escolha o repositório

Pesquise seus repositórios, clique no que vai receber o deploy e depois escolha:

  • Branch — o branch que entra no ar. Cada push para ele recebe deploy automático.
  • Pasta do projeto — só para um repositório com vários projetos (um monorepo), por exemplo apps/web. Deixe vazio quando o projeto estiver na raiz.

Clique em Continuar.

Ainda não tem repositório? Ou comece com um modelo cria um novo repositório na sua conta do GitHub a partir de um dos nossos modelos — Next.js, Laravel, Express, Flask ou um site estático. O código é seu, e você publica as mudanças com um push.

3. O que detectamos

Lemos o repositório e descobrimos como fazer o build e iniciá-lo. Você não escreve nenhuma configuração. Reconhecemos:

StackO que procuramos
Node.jsNext.js, Nuxt, SvelteKit, Astro, Express, Fastify, Koa, Hono, NestJS; npm, yarn ou pnpm pelo arquivo de lock
PHPLaravel, Symfony, Slim, CodeIgniter ou PHP puro (8.2–8.4)
PythonDjango, Flask, FastAPI
Goum go.mod na raiz
Sites estáticosHTML puro ou um build de front-end: Vite (React, Vue, Svelte), Create React App, Angular, Gatsby, Docusaurus, VitePress, uma exportação estática de Next.js ou Nuxt

Se o seu repositório tiver um Dockerfile próprio, fazemos o build com ele do jeito que está — essa também é a forma de rodar uma stack que não está na lista.

Você pode alterar depois os comandos detectados de instalação, build e inicialização em Configurações → Configurações de build. Observações para cada stack: Laravel, Node.js, Next.js e Nuxt, Python, sites estáticos.

4. Recursos e preço

Escolha quanto o seu aplicativo precisa com três controles deslizantes:

RecursoPreçoFaixa
MemóriaR$ 34,76 por GB por mês256 MB, 512 MB e depois GB inteiros até 16 GB
CPUR$ 23,17 por núcleo por mêsde 1 a 8 núcleos
Disco10 GB inclusos para cada GB de memória, depois R$ 0,87 por GB por mêsde 5 a 500 GB, de 5 em 5 GB

Alguns exemplos:

MemóriaCPUDiscoPor mês
512 MB1 núcleo5 GBR$ 40,55
1 GB1 núcleo10 GBR$ 57,94
2 GB2 núcleos20 GBR$ 115,87
4 GB2 núcleos60 GBR$ 202,77

O painel mostra o total mensal enquanto você move os controles. Você pode alterar os recursos quando quiser depois; o aplicativo mantém seus dados. Todo aplicativo também inclui 500 GB de tráfego por mês por projeto — veja Cobrança dos aplicativos.

5. O endereço

Escolha como o aplicativo pode ser acessado — nada vem selecionado de antemão:

  • Endereço público — aberto para a internet em um endereço grátis com HTTPS, https://<name>.rivervo.app. Você pode conectar seu próprio domínio depois do lançamento — veja Domínios próprios.
  • Somente interno — sem endereço na internet; só os outros serviços do aplicativo o acessam. Ideal para uma API ou um backend chamado por outro serviço do aplicativo — veja Comunicação entre serviços.

Escolha o nome (letras latinas minúsculas, números e hífens, de 3 a 42 caracteres); o painel diz na hora se ele está livre. Você pode trocar entre as duas opções depois em Configurações → Endereço público.

6. Lançamento — e o teste grátis

Clique em Lançar e cadastre seu cartão. Seu primeiro aplicativo vem com 3 dias de teste grátis: o cartão não é cobrado nesses 3 dias, e o primeiro pagamento é feito quando o teste termina. Depois disso, o aplicativo é cobrado mensalmente pelo preço mostrado.

O teste é oferecido uma única vez por conta — para o primeiro aplicativo que você lançar.

7. O primeiro deploy

Depois do lançamento, o painel mostra cada etapa ao vivo: busca do código, verificação de segurança, build, inicialização e ativação do endereço. Normalmente leva alguns minutos. Antes de cada versão, verificamos se há código malicioso escondido; um projeto que o contenha não passa por build nem é executado.

Quando o deploy termina, Abrir leva você ao seu aplicativo no ar (para um aplicativo com endereço público).

Se o lançamento não terminar, o painel mostra a etapa e o log. Corrija a causa no seu código ou nas Variáveis e clique em Tentar de novo — nada mais é cobrado. Explicar este erro traz uma explicação curta do log e de como corrigir o problema (veja Ferramentas para desenvolvedores).

Próximos passos

Ainda com dúvidas?

Fale com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte