Lançar a sua primeira aplicação a partir do GitHub.
Ligue o GitHub, escolha um repositório, os recursos e um endereço e fique online em poucos minutos — com 3 dias de teste gratuito na sua primeira aplicação.
As Aplicações executam o seu próprio código — um site, uma API, uma tarefa em segundo plano — diretamente a partir do seu repositório Git. Não escolhe um servidor nem um plano de alojamento: escolhe um repositório, nós descobrimos como fazer o build e executá-lo, e cada push fica publicado sozinho.
Tudo acontece no novo painel (rivervo.com/panel) → Aplicações → Nova aplicação.
1. Ligar a sua conta Git
O GitHub está sempre disponível. Clique em Ligar o GitHub: o GitHub pergunta onde instalar a Rivervo (na sua conta pessoal ou numa organização) e que repositórios pode ler. Nada é escrito nos seus repositórios.
Já instalou a Rivervo no GitHub antes? Use Já a instalou no GitHub? Associe-a.
O GitLab e o Bitbucket aparecem como botões adicionais acima da lista de repositórios, onde estiverem disponíveis. A ligação funciona da mesma forma: autoriza a Rivervo a ler os seus repositórios e a adicionar um webhook para deploys automáticos. O seu código nunca é alterado.
2. Escolher o repositório
Pesquise nos seus repositórios, clique naquele que quer publicar e escolha:
- Ramo — o ramo que fica publicado. Cada push para ele é publicado automaticamente.
- Pasta do projeto — só para um repositório com vários projetos (um monorepo), por exemplo
apps/web. Deixe vazio quando o projeto está na raiz.
Clique em Continuar.
Ainda não tem repositório? Ou comece a partir de um modelo cria um repositório novo na sua conta GitHub a partir de um dos nossos modelos — Next.js, Laravel, Express, Flask ou um site estático. O código é seu e publica as alterações com um push.
3. O que detetamos
Lemos o repositório e descobrimos como fazer o build e arrancá-lo. Não precisa de escrever nenhuma configuração. Reconhecemos:
| Stack | O que procuramos |
|---|---|
| Node.js | Next.js, Nuxt, SvelteKit, Astro, Express, Fastify, Koa, Hono, NestJS; npm, yarn ou pnpm pelo ficheiro de lock |
| PHP | Laravel, Symfony, Slim, CodeIgniter ou PHP simples (8.2–8.4) |
| Python | Django, Flask, FastAPI |
| Go | um go.mod na raiz |
| Sites estáticos | HTML simples 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 tal como está — é também a forma de executar uma stack que não esteja na lista.
Pode alterar mais tarde os comandos de instalação, build e arranque detetados em Definições → Definições de build. Notas para cada stack: Laravel, Node.js, Next.js e Nuxt, Python, sites estáticos.
4. Recursos e preço
Escolha o que a sua aplicação precisa com três cursores:
| Recurso | Preço | Intervalo |
|---|---|---|
| Memória | € 6,72 por GB por mês | 256 MB, 512 MB e depois GB inteiros até 16 GB |
| CPU | € 4,48 por núcleo por mês | 1 a 8 núcleos |
| Disco | 10 GB incluídos por cada GB de memória, depois € 0,17 por GB por mês | 5 a 500 GB, em passos de 5 GB |
Alguns exemplos:
| Memória | CPU | Disco | Por mês |
|---|---|---|---|
| 512 MB | 1 núcleo | 5 GB | € 7,82 |
| 1 GB | 1 núcleo | 10 GB | € 11,18 |
| 2 GB | 2 núcleos | 20 GB | € 22,36 |
| 4 GB | 2 núcleos | 60 GB | € 39,14 |
O painel mostra o total mensal à medida que move os cursores. Pode alterar os recursos a qualquer momento; a aplicação mantém os dados. Cada aplicação inclui também 500 GB de tráfego por mês por projeto — consulte Faturação das aplicações.
5. O endereço
Escolha como a aplicação pode ser acedida — nada vem selecionado à partida:
- Endereço público — aberto a partir da internet num endereço gratuito com HTTPS,
https://<name>.rivervo.app. Pode ligar o seu próprio domínio depois do lançamento — consulte Domínios próprios. - Apenas interno — sem endereço na internet; só os outros serviços da aplicação chegam a ela. Adequado para uma API ou um backend chamado por outro serviço da aplicação — consulte Comunicação entre serviços.
Escolha o nome (letras latinas minúsculas, algarismos e hífenes, 3 a 42 caracteres); o painel indica de imediato se está livre. Pode alternar entre as duas opções mais tarde em Definições → Endereço público.
6. Lançar — e o período de teste gratuito
Clique em Lançar e adicione o seu cartão. A sua primeira aplicação tem 3 dias de teste gratuito: o cartão não é cobrado durante esses 3 dias e o primeiro pagamento é feito quando o teste termina. A partir daí, a aplicação é faturada mensalmente ao preço indicado.
O teste é oferecido uma vez por conta — na primeira aplicação que lançar.
7. O primeiro deploy
Depois do lançamento, o painel mostra cada passo em direto: obter o código, uma verificação de segurança, o build, o arranque e a ativação do endereço. Normalmente demora alguns minutos. Antes de cada versão, verificamos se o código tem código malicioso escondido; um projeto que o contenha não é compilado nem executado.
Quando o deploy termina, Abrir leva-o à sua aplicação publicada (numa aplicação com endereço público).
Se o lançamento não terminar, o painel mostra o passo e o registo. Corrija a causa no seu código ou nas Variáveis e clique em Tentar de novo — não é cobrado mais nada. Explicar este erro dá-lhe uma explicação curta do registo e de como corrigir o problema (consulte Ferramentas para programadores).