Começar

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.

5 MIN DE LEITURA

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:

StackO que procuramos
Node.jsNext.js, Nuxt, SvelteKit, Astro, Express, Fastify, Koa, Hono, NestJS; npm, yarn ou pnpm pelo ficheiro de lock
PHPLaravel, Symfony, Slim, CodeIgniter ou PHP simples (8.2–8.4)
PythonDjango, Flask, FastAPI
Goum go.mod na raiz
Sites estáticosHTML 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:

RecursoPreçoIntervalo
Memória€ 6,72 por GB por mês256 MB, 512 MB e depois GB inteiros até 16 GB
CPU€ 4,48 por núcleo por mês1 a 8 núcleos
Disco10 GB incluídos por cada GB de memória, depois € 0,17 por GB por mês5 a 500 GB, em passos de 5 GB

Alguns exemplos:

MemóriaCPUDiscoPor mês
512 MB1 núcleo5 GB€ 7,82
1 GB1 núcleo10 GB€ 11,18
2 GB2 núcleos20 GB€ 22,36
4 GB2 núcleos60 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).

E agora

Ainda com dúvidas?

Fale connosco por chat — a AI responde de imediato e um engenheiro entra quando for preciso, a qualquer hora.

Contactar o suporte