blog
Painéis

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.

JR · · 9 min de leitura · 2 tabelas · 2 blocos de código

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
  1. Como o Git do Plesk publica um site
  2. O que conferir antes do primeiro deploy
  3. Como publicar a partir de um repositório remoto no Plesk
  4. Publicar a partir de um repositório local na assinatura
  5. Quando usar cada modo e o que roda depois do deploy
  6. Por que o site não atualiza depois do push
  7. 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:

  1. 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.
  2. Pasta de destino: o diretório do servidor que recebe os arquivos. Por padrão é a raiz do site, normalmente httpdocs.
  3. Branch publicado: o branch cujo conteúdo vai para a pasta de destino. Commits em outros branches não chegam ao site.
  4. 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:

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.

Ordem do primeiro deploy remotoCadastrar chave SSHChave pública do Plesk vira deploy keyCriar repositório remotoCole a URL SSH na extensão GitCadastrar webhookPush avisa o PleskConferir o último commitTela Git mostra a publicação
Ordem para o primeiro deploy a partir de um repositório remoto. Nenhuma etapa depende de número.

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:

  1. 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.

  1. 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.

Como conter um deploy que quebrou o siteMudar o modo para manualImpede novos deploys enquanto investigaReverter o commit e publicarHistórico mantém o registro da correçãoSite voltou ao normal?Se sim, volte ao modo automáticoRestaurar backup de arquivosÚltimo recurso, deixe o banco de fora
Contenção de um deploy que quebrou o site. A restauração de backup é o último recurso.

Referências

  1. Documentação oficial (plesk) — Plesk Obsidian Customer Guide (zh-TW). Consultado em 2026-11-14.
Leia também