Server Manager/ Help
Open Server Manager →

Implantar um app web a partir de um repositório git

Cole a URL do seu repositório, digite seu domínio e clique em Clonar e implantar.

Não tem um repositório git? → Implante um app web a partir do seu computador

Se o seu app web está em um repositório git público (GitHub, GitLab, Bitbucket, Codeberg, Gitea — qualquer hospedagem git via HTTPS), o Server Manager consegue cloná-lo diretamente no seu servidor. Depois do clone, detectamos o ambiente de execução (Node, Python ou Go) e instalamos tudo o que ele precisar. Mais tarde, as atualizações ficam a um clique em Puxar a versão mais recente do git.

1. Abra o menu Ações

Na barra superior, clique em Ações. Na paleta que abrir, escolha Implantar do meu computador (em "Trazer algo para cá") — ou simplesmente digite "implantar" na caixa de busca.

Clique em Ações na barra superior e escolha Implantar do meu computador
Clique em Ações na barra superior e escolha Implantar do meu computador

2. Escolha "App web" e altere a Origem

Uma nova janela será aberta. Clique na aba App web. Em seguida, em Origem, clique em De um repositório git.

Clique em App web e altere a Origem para De um repositório git
Clique em App web e altere a Origem para De um repositório git

3. Cole a URL do seu repositório

Cole a URL https:// do seu repositório — por exemplo, https://github.com/yourname/my-api. Use o formato HTTPS, não o formato SSH git@.

Cole a URL do seu repositório no campo
Cole a URL do seu repositório no campo

4. Digite seu domínio

Digite o endereço em que você quer que o app fique disponível — por exemplo, api.example.com. Você pode deixar em branco por enquanto e adicionar um domínio depois.

Digite seu domínio no campo Domínio
Digite seu domínio no campo Domínio

5. Clique em "Clonar e implantar"

Clique em Clonar e implantar no canto inferior direito
Clique em Clonar e implantar no canto inferior direito

6. Pronto

A janela fecha e o chat assume. Nós clonamos seu repositório, instalamos o ambiente de execução se necessário, iniciamos seu app pelo e apontamos o para ele como . Quando terminar, seu app aparecerá na tela inicial com um ponto verde — e um botão **Puxar a versão mais recente do git** aparecerá no painel de serviço dele.

Seu novo app web aparece na visão geral com um ponto verde
Seu novo app web aparece na visão geral com um ponto verde

Atualizando depois

Clique em **Puxar a versão mais recente do git** no painel de serviço do app — nós vamos executar git pull para trazer seus commits mais recentes, instalar novas dependências e reiniciar seu app. Para repositórios privados, gere uma chave de deploy no mesmo painel; os pulls não pedirão credenciais novamente. A explicação completa (tratamento de conflitos, chaves de deploy e comportamento de subdiretórios em monorepos) está no artigo sobre Puxar a versão mais recente.

Quer ajustar alguns detalhes primeiro?

Há duas seções Avançadas na janela.

Avançado (git) — branch, subdiretório, repositórios privados
A seção Avançado (git) expandida — Branch, Subdiretório, Token de acesso pessoal
A seção Avançado (git) expandida — Branch, Subdiretório, Token de acesso pessoal

Branch. Substitui a branch padrão — qualquer coisa aceita por git clone --branch, incluindo tags e SHAs de commit.

Subdiretório. Para monorepos: implante apenas uma pasta dentro do repositório (por exemplo, apps/api). O sparse-checkout mantém o Puxar versão mais recente funcionando.

Token de acesso pessoal. Para repositórios privados — usado uma vez para o clone inicial e depois removido. Para pulls de longo prazo, gere uma **chave de deploy** após a implantação.

Avançado — ambiente de execução, modo de implantação, nome do app, porta

Os campos de ambiente de execução funcionam da mesma forma que ao implantar a partir do seu computador — substituição do ambiente de execução, Nativo vs Contêiner, nome do app, porta, comando de inicialização e variáveis de ambiente. Veja Implantar um app web a partir do seu computador para a explicação completa, e Nativo vs Contêiner para entender em detalhes as vantagens e desvantagens de cada modo de implantação.