blog
Painéis

Criar um repositório Git no cPanel sem usar GitHub

Passo a passo documental para criar, clonar e empurrar código para um repositório hospedado na própria conta, com as cinco mensagens de erro que mais travam o primeiro push.

JR · · 7 min de leitura · 3 tabelas · 5 blocos de código

Resposta curta: abra Git Version Control no cPanel, clique em Create e informe o Repository Path como `repositories/meusite`, fora de public_html. O cPanel devolve uma URL SSH para clonar na sua máquina. Sem chave SSH autorizada não há clone nem push, e sem um arquivo `.cpanel.yml` no repositório o push não publica nada no site.

Neste artigo
  1. O que a tela Git Version Control faz e o que ela não faz
  2. Libere o SSH e autorize a chave antes de criar o repositório
  3. Criando o repositório pela interface
  4. Por que repositories/ não é public_html, e por que isso evita metade dos problemas
  5. Clonar na máquina local e fazer o primeiro push
  6. Cinco mensagens de erro e o que cada uma significa
  7. O que esse arranjo resolve e o que ele não substitui

O que a tela Git Version Control faz e o que ela não faz

No cPanel existe um ícone chamado Git Version Control, na seção Arquivos. Ele cria e gerencia repositórios Git dentro da sua própria conta de hospedagem. Segundo a documentação oficial do cPanel, a interface permite criar repositórios, clonar repositórios existentes, gerenciar branches e, quando configurado, implantar arquivos.

Duas coisas que a tela não faz sozinha, e é aqui que a maioria se perde:

Para quem só quer histórico de versões do próprio site e um lugar para onde empurrar o código, isso basta. E sai sem depender de conta em serviço externo.

Libere o SSH e autorize a chave antes de criar o repositório

O acesso ao repositório é feito por SSH. Sem isso, não há clone nem push. Antes de criar qualquer coisa:

  1. Entre no cPanel e abra SSH Access (seção Segurança). Se o ícone não existir, o acesso SSH está desabilitado na conta e você precisa pedir a liberação ao suporte da hospedagem.
  2. Dentro de SSH Access, clique em Manage SSH Keys.
  3. Gere uma chave ali (Generate a New Key) ou importe a chave pública que você já usa na sua máquina (Import Key).
  4. Depois de criada ou importada, a chave aparece na lista como *not authorized*. Clique em Manage ao lado dela e depois em Authorize. Enquanto a chave estiver sem autorização, todo push e clone será recusado.

Resultado esperado na tela: a chave pública listada com o status authorized.

Se você gerou a chave no servidor, baixe a chave privada pelo botão View/Download Key e guarde em ~/.ssh/ na sua máquina, com permissão 600. Teste a conexão antes de seguir:

ssh -p 22 [email protected]

Troque usuario pelo nome de usuário do cPanel e 22 pela porta SSH que sua hospedagem usa (muitas usam porta alternativa). O resultado esperado é um prompt de shell do servidor. Se vier Permission denied (publickey), a chave ainda não está autorizada ou o cliente está oferecendo outra chave.

Criando o repositório pela interface

Onde fica o Git Version Control no cPanel

No cPanel, procure por Git Version Control. Na primeira vez a tela mostra a lista vazia e um botão Create.

Os três campos do formulário e qual deles decide tudo

A documentação do cPanel descreve a criação com os campos abaixo.

Campo O que colocar Observação
Clone a Repository Deixe desligado Ligue só se for clonar um repositório que já existe em outro lugar
Repository Path repositories/meusite Caminho relativo ao diretório inicial da conta
Repository Name meusite Nome de exibição na lista, não afeta o caminho

O campo Repository Path é o que decide tudo. A documentação do cPanel orienta usar um diretório que não esteja publicado na web. O padrão sugerido é repositories/, dentro do diretório inicial (home) da conta.

O que o cPanel devolve depois do Create

Clique em Create. O cPanel cria o diretório, inicializa o repositório e mostra uma tela de sucesso com o endereço de clone por SSH, algo no formato:

ssh://[email protected]:22/home/usuario/repositories/meusite

Guarde essa URL. É ela que você vai usar na máquina local.

Por que repositories/ não é public_html, e por que isso evita metade dos problemas

O diretório inicial da sua conta tem várias pastas. Só uma delas é servida pelo navegador.

Caminho Quem enxerga Para que serve
/home/usuario/public_html Qualquer visitante, pela web Arquivos do site no ar
/home/usuario/repositories/meusite Só quem tem acesso SSH/FTP à conta Histórico Git, objetos, branches e os arquivos do projeto

Se você colocar o Repository Path dentro de public_html, o Git cria uma pasta .git em uma área pública. Dependendo da configuração do servidor web, o conteúdo dessa pasta pode ficar acessível pela internet, e dentro dela está o histórico inteiro do seu código: arquivos de configuração antigos, credenciais que você removeu em um commit posterior, caminhos internos. É uma exposição evitável.

A consequência prática do caminho separado: enquanto não houver deploy configurado, o push não muda nada no site. Você pode versionar à vontade sem risco de quebrar a página no ar. A publicação é um segundo passo, com .cpanel.yml, e é deliberado.

Clonar na máquina local e fazer o primeiro push

No seu computador, dentro da pasta onde quer guardar o projeto:

git clone ssh://[email protected]:22/home/usuario/repositories/meusite

Resultado esperado: a mensagem warning: You appear to have cloned an empty repository. Isso é normal. O repositório acabou de ser criado e não tem nenhum commit, portanto não tem branch nem arquivos.

Entre na pasta criada, coloque os arquivos do projeto e faça o primeiro commit:

cd meusite
git add .
git commit -m "primeiro commit"
git push origin main

O nome do branch depende da versão do Git instalada na sua máquina. Rode git branch --show-current para saber se é main ou master e use o nome que aparecer no comando de push.

Resultado esperado: linhas de Counting objects, Writing objects e, no fim, algo como * [new branch] main -> main. Volte ao cPanel, atualize a tela Git Version Control e o repositório agora mostra o branch e a informação do último commit. Como o repositório tem diretório de trabalho, o Gerenciador de Arquivos também mostra os arquivos do projeto dentro de repositories/meusite, e não só a pasta .git. Isso não publica nada: esse diretório continua fora de public_html.

Da chave SSH ao primeiro push no cPanelAutorizar chaveSSH Access, Manage SSH KeysCriar repositórioPath em repositories/meusiteClonar na máquinaURL ssh:// da tela de sucessoCommit e pushBranch main ou masterConferir no cPanelBranch e último commit visíveis
Nenhuma dessas etapas publica o site: a publicação depende de .cpanel.yml.

Cinco mensagens de erro e o que cada uma significa

Mensagem Causa provável O que fazer
Permission denied (publickey) Chave não autorizada em Manage SSH Keys, ou o cliente local está oferecendo outra chave Autorize a chave no cPanel; teste com ssh -v para ver qual chave o cliente envia
warning: You appear to have cloned an empty repository Repositório recém-criado, sem commit Não é erro. Faça o primeiro commit e o push
Connection refused ou timeout Porta SSH errada ou SSH não liberado na conta Confirme a porta com a hospedagem e inclua :porta na URL de clone
src refspec main does not match any Você está empurrando um branch que não existe localmente Rode git branch --show-current e use o nome correto
.git acessível pelo navegador Repository Path criado dentro de public_html Veja o reparo abaixo

Como reparar um repositório criado dentro de public_html

Se você criou o repositório dentro de public_html, faça backup completo da conta antes de qualquer coisa (Gerenciador de Arquivos, ou o backup do painel). Depois:

  1. Em Git Version Control, clique em Manage no repositório e use a opção de remover. Entenda o efeito real: essa opção tira o repositório da lista gerenciada pelo cPanel e não apaga nada do disco. O diretório continua onde estava, com a pasta .git dentro, inclusive acessível pela web. Por isso a limpeza manual do passo 2 é obrigatória, não opcional.
  2. No Gerenciador de Arquivos, ative Show Hidden Files (dotfiles) nas configurações, entre em public_html e apague a pasta .git que ficou lá. Confirme antes que o backup do passo anterior está pronto: apagar .git elimina o histórico daquela cópia.
  3. Crie o repositório de novo com Repository Path em repositories/.

Se por algum motivo o repositório precisar continuar onde está, bloqueie o acesso à pasta pela web. No Gerenciador de Arquivos, abra public_html, selecione o arquivo .htaccess (se não existir, crie um com esse nome) e clique em Edit. Cole as linhas abaixo no topo do arquivo, antes de qualquer regra do WordPress:

# bloqueia acesso web a .git e aos arquivos dentro dele
RedirectMatch 404 /\.git

A regra responde 404 para qualquer URL do site que contenha /.git, incluindo /.git/config e /.git/HEAD. Salve e teste a mudança abrindo seudominio.com.br/.git/config no navegador: o esperado é 403 ou 404, nunca o conteúdo do arquivo. Se o site sair do ar depois da edição, desfaça apagando essas linhas do .htaccess.

Reparo de repositório criado dentro de public_htmlO repositório está em public_html?Se não, nada a fazerFaça backup completo da contaGerenciador de Arquivos ou painelRemover da lista do cPanelNão apaga nada do discoApagar a pasta .git manualmenteAtive Show Hidden FilesRecriar com Path em repositories/Fora da área públicaSe precisar manter no lugarRedirectMatch 404 no .htaccess
Remover pelo painel não limpa o disco: a exclusão manual da pasta .git é obrigatória.

O que esse arranjo resolve e o que ele não substitui

Repositório na própria conta resolve bem três situações: guardar histórico de um site que hoje só existe por FTP, ter uma cópia versionada do tema filho do WordPress, e trabalhar sozinho ou em dupla com acesso SSH à mesma conta.

Não resolve: backup. O repositório mora no mesmo servidor e na mesma conta do site. Se a conta for perdida, o histórico vai junto. O clone na sua máquina já é uma cópia completa do histórico, e manter esse clone é parte do plano, não um detalhe.

Também não substitui o GitHub para fluxo de equipe com revisão de código. Para isso, nada impede manter dois remotes: o GitHub para colaboração e o repositório do cPanel como destino de publicação.

O próximo passo, quando você quiser que o push efetivamente atualize o site, é criar o arquivo .cpanel.yml na raiz do repositório definindo quais arquivos vão para public_html. Até lá, o push é seguro: ele guarda versão, não publica.

Referências

  1. Documentação oficial (cpanel) — Guide to Git: Host Git Repositories on a cPanel Account. Consultado em 2026-10-16.
Leia também