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.

Resposta curta: 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.
Neste artigo
- Como o Git do Plesk publica um site
- O que conferir antes do primeiro deploy
- Como publicar a partir de um repositório remoto no Plesk
- Publicar a partir de um repositório local na assinatura
- Quando usar cada modo e o que roda depois do deploy
- Por que o site não atualiza depois do push
- Como desfazer um deploy que quebrou o site
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, 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.phpnem a pastauploads. 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 [email protected]: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://[email protected]/~/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 [email protected] (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.
Referências
- Documentação oficial (plesk) — Plesk Obsidian Customer Guide (zh-TW). Consultado em 2026-11-14.