# Como publicar um site pelo Git no Plesk

Repositório remoto ou local, pasta de destino, branch, publicação a cada push e onde procurar o erro quando o site continua igual depois do commit.

> No Plesk, o deploy por Git fica em Sites e Domínios > Git: você conecta um repositório remoto ou cria um local, define a pasta de destino, o branch e o modo automático com webhook. Não fizemos medição própria. O passo a passo segue a documentação do Plesk Obsidian, e os nomes dos botões podem variar conforme a versão.

João Rizzon · 2026-11-15 · Painéis

---

## Como o Git do Plesk publica um site

O deploy por Git no Plesk depende de uma extensão chamada **Git**, que aparece dentro da assinatura, em **Sites e Domínios**. Ela trabalha com quatro decisões que você toma uma vez e que definem todo o resto:

- **Onde fica o repositório**: num serviço remoto (GitHub, GitLab, Bitbucket ou um servidor Git próprio) ou num repositório local criado dentro da própria assinatura.
- **Pasta de destino**: o diretório do servidor que recebe os arquivos. Por padrão é a raiz do site, normalmente `httpdocs`.
- **Branch publicado**: o branch cujo conteúdo vai para a pasta de destino. Commits em outros branches não chegam ao site.
- **Modo de publicação**: automático (a cada atualização), manual (só quando você clica) ou sem publicação (o Plesk guarda o repositório, mas não copia nada).

Boa parte dos problemas de "fiz push e o site não mudou" começa numa dessas quatro escolhas. Por isso vale anotá-las antes de começar. O resto (webhook, chave SSH, ação adicional e cache) está na seção de diagnóstico, mais abaixo.

Este guia descreve as telas a partir do [Plesk Obsidian Customer Guide](https://docs.plesk.com/zh-TW/obsidian/customer-guide_sitemap.xml), consultado em 14/11/2026. Não fizemos medição própria. Os nomes de botões podem variar conforme a versão do Plesk, o idioma do painel e a versão da extensão Git, então confira na sua tela antes de seguir.

## O que conferir antes do primeiro deploy

**Backup primeiro.** A publicação por Git sobrescreve arquivos na pasta de destino. Se o seu `httpdocs` já tem um WordPress funcionando e o repositório tem outra estrutura, arquivos podem ser substituídos. No Plesk, gere uma cópia em **Sites e Domínios > Backup Manager** (ou baixe a pasta pelo Gerenciador de Arquivos) antes do primeiro deploy.

Confira também:

- **A extensão Git está disponível.** Se não houver ícone ou link Git em Sites e Domínios, o provedor não habilitou. Isso se resolve com o suporte da hospedagem, não no seu lado.
- **Acesso SSH, se for usar repositório local.** Para enviar commits direto ao servidor, a assinatura precisa de acesso ao shell liberado em **Hospedagem e DNS > Acesso à hospedagem web** (o nome exato varia por versão).
- **O que entra no repositório.** Em WordPress, o comum é versionar só o tema ou plugin próprio, e não o `wp-config.php` nem a pasta `uploads`. Publicar o WordPress inteiro por Git funciona, mas aumenta a chance de apagar mídia enviada pelo painel.

Se o repositório contém só um tema, aponte a pasta de destino para `httpdocs/wp-content/themes/nome-do-tema`, não para `httpdocs`. Esse detalhe evita a maioria dos acidentes.

## Como publicar a partir de um repositório remoto no Plesk

Esse é o caso de quem já tem o código no GitHub ou similar.

### Adicionar o repositório

Em **Sites e Domínios**, clique em **Git** no domínio desejado. Escolha a opção de repositório remoto e cole a URL. Para repositório privado, use a URL SSH (formato `git@github.com:usuario/repo.git`). O Plesk mostra uma **chave SSH pública** nessa tela.

### Autorizar o Plesk no serviço remoto

Copie a chave pública e cadastre no repositório remoto. No GitHub, isso fica nas configurações do repositório, em **Deploy keys**. Sem esse passo, o Plesk não consegue ler um repositório privado e a criação falha com erro de autenticação.

### Definir pasta de destino e modo

Ainda na criação, informe o **caminho de publicação** (por exemplo, `httpdocs`) e escolha o modo. Para atualização a cada push, selecione o modo automático. Depois, confira na tela do repositório qual branch está selecionado para publicação.

### Como fazer o push disparar a publicação com webhook

Com repositório remoto, o Plesk não sabe sozinho que houve um push. Ele exibe uma **URL de webhook** na tela do repositório. Cadastre essa URL no serviço remoto (no GitHub, em **Webhooks**, evento de push). A partir daí, cada push avisa o Plesk, que puxa as mudanças e, no modo automático, publica.

Sem webhook, o modo automático não dispara. Você ainda pode clicar em **Pull Updates** (Puxar atualizações) e depois em **Deploy** manualmente.

## Publicar a partir de um repositório local na assinatura

Aqui o repositório mora no próprio servidor e você faz push direto para ele, sem GitHub no meio. Funciona bem para quem trabalha sozinho.

### Criar o repositório

Em **Git**, escolha a opção de repositório local. Defina pasta de destino e modo, como no caso remoto. O Plesk mostra a URL do repositório, que usa SSH e o usuário da assinatura.

### Ligar o seu computador ao repositório

No terminal, dentro da pasta do projeto, rode os comandos abaixo. A URL é um **exemplo**: substitua pela que aparece na sua tela do Plesk.

```
git remote add plesk ssh://usuario@exemplo.com.br/~/git/meusite.git
git push plesk main
```

A primeira linha cria um atalho chamado `plesk` apontando para o servidor. A segunda envia o branch `main` para lá. Na primeira conexão, o terminal pergunta se confia no servidor (responda `yes`) e pede a senha do usuário da assinatura, a menos que você tenha cadastrado uma chave SSH.

O resultado esperado é uma saída terminando com algo como `main -> main`. Se o modo for automático e o branch enviado for o branch publicado, os arquivos já estão na pasta de destino.

### Conferir se o branch enviado é o que o Plesk publica

Se o seu projeto usa `master` e o Plesk publica `main` (ou o contrário), o push é aceito, mas nada aparece no site. Ajuste o branch publicado nas configurações do repositório no Plesk.

## Quando usar cada modo e o que roda depois do deploy

| Modo | O que acontece no push | Quando usar |
|---|---|---||
| Automático | O Plesk publica no destino logo após receber as mudanças | Site em que o branch publicado é sempre estável |
| Manual | O Plesk recebe as mudanças, mas só publica ao clicar em Deploy | Quando você quer revisar antes de ir ao ar |
| Sem publicação | O repositório é atualizado, a pasta de destino não | Guardar código no servidor sem afetar o site |

Nas configurações do repositório existe a opção de **ações adicionais de publicação**: comandos de shell que rodam depois de copiar os arquivos. Exemplos comuns (fictícios, adapte ao seu projeto) são instalar dependências com `composer install` ou limpar cache. Cada comando roda com o usuário da assinatura e dentro dos limites dela.

Uma ação adicional que falha é uma causa frequente de deploy "pela metade": os arquivos chegam, mas a etapa seguinte não. Para testar um comando antes de colocá-lo no Plesk, conecte por SSH. No terminal do seu computador, rode `ssh usuario@exemplo.com.br` (troque pelo usuário da assinatura e pelo seu domínio), responda `yes` na primeira conexão e digite a senha. Depois rode `cd httpdocs` para entrar na pasta de destino (ajuste se o seu caminho de publicação for outro) e rode o comando, por exemplo `composer install`. Se ele terminar sem nenhuma linha com `error`, `fatal` ou `command not found`, está pronto para virar ação adicional. Se aparecer erro, a mensagem diz o que falta (programa não instalado, permissão, arquivo inexistente). Sem acesso SSH, a alternativa é salvar a ação, clicar em **Deploy** e ler a mensagem de erro que aparece na tela do repositório em **Git**.

## Por que o site não atualiza depois do push

O diagnóstico aqui fica restrito ao deploy no Plesk. Se o deploy roda e o problema é um commit com erro de código, o caminho é outro.

Comece pela tela do repositório em **Git**. Ela mostra o branch publicado, o último commit recebido e a data da última publicação. Erros de pull, autenticação ou ação adicional aparecem como mensagem nessa tela ou na notificação do painel após a tentativa. A forma exata de exibir esse registro muda entre versões da extensão, então procure por um link de detalhes ou log ao lado da última publicação.

| Sintoma | Causa provável | O que fazer |
|---|---|---||
| Último commit na tela é antigo | Webhook não cadastrado ou falhando | Confira o webhook no serviço remoto e veja se ele registra entrega com erro |
| Commit novo aparece, site igual | Modo manual ou branch errado | Clique em Deploy ou corrija o branch publicado |
| Erro de autenticação | Chave SSH do Plesk não cadastrada | Recadastre a chave pública como deploy key |
| Arquivos no lugar errado | Pasta de destino incorreta | Ajuste o caminho de publicação |
| Arquivos chegaram, site quebrado | Ação adicional falhou | Rode o comando por SSH e leia o erro |
| Tudo certo, navegador mostra versão antiga | Cache do site, do plugin ou da CDN | Limpe o cache antes de investigar o Git |

No GitHub, a página do webhook mostra cada entrega e a resposta do servidor. Uma entrega com erro ali significa que o aviso nem chegou ao Plesk, o que encurta a busca. Para erros do site depois do deploy, use **Sites e Domínios > Logs**, que mostra o log do servidor web.

Uma última causa simples: cache. Plugin de cache do WordPress ou CDN pode servir a versão anterior por minutos. Teste numa janela anônima antes de mexer em configurações.

## Como desfazer um deploy que quebrou o site

Se um deploy quebrou o site, primeiro contenha o problema: em **Git**, nas configurações do repositório, troque o modo para manual. Isso não conserta nada, só impede que novos pushes vão ao ar enquanto você investiga. Depois, há duas saídas, da mais rápida para a mais completa:

- **Reverter no Git e publicar de novo.** No terminal, dentro da pasta do projeto no seu computador, rode:

```
   git log --oneline -5
   git revert --no-edit a1b2c3d
   git push plesk main
```

A primeira linha lista os 5 últimos commits, um por linha, no formato `a1b2c3d Ajusta cabeçalho`: o código à esquerda é o identificador (hash). Ache o commit que quebrou o site pela mensagem e copie o hash dele. A segunda linha cria um commit novo que desfaz aquele (troque `a1b2c3d` pelo hash copiado); a saída esperada é algo como `[main e4f5g6h] Revert "Ajusta cabeçalho"`. O histórico não é apagado, só ganha um commit de correção. A terceira linha envia a correção: use `plesk` se o repositório é local na assinatura, ou `origin` se ele está no GitHub. A saída termina com `main -> main`. Troque `main` pelo seu branch publicado, se for outro. Como você colocou o modo em manual na contenção, entre em **Git** e clique em **Deploy** (com repositório remoto, clique antes em **Pull Updates**). Confira o site e só então volte ao modo automático.

- **Restaurar o backup.** Use o backup feito antes do primeiro deploy, pelo Backup Manager. Risco: restaurar o backup completo volta arquivos e banco de dados para a data dele, então posts, comentários, pedidos e uploads feitos depois disso são perdidos. Antes de restaurar, gere um backup novo do estado atual (assim dá para voltar atrás da restauração). Se a tela de restauração permitir escolher o que restaurar, marque só os arquivos do site e deixe o banco de fora: o Git só mexe em arquivos.

Um aviso: remover o repositório no Plesk não desfaz os arquivos já copiados para a pasta de destino. Ele apenas para de publicar. Para limpar, use o Gerenciador de Arquivos ou o backup.

