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.

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
- O que a tela Git Version Control faz e o que ela não faz
- Libere o SSH e autorize a chave antes de criar o repositório
- Criando o repositório pela interface
- Por que repositories/ não é public_html, e por que isso evita metade dos problemas
- Clonar na máquina local e fazer o primeiro push
- Cinco mensagens de erro e o que cada uma significa
- 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:
- Ela não publica o site. Criar o repositório e dar push não copia nada para a pasta que o navegador abre. A implantação só acontece se existir um arquivo
.cpanel.ymlno repositório definindo o que copiar para onde. - Ela não é o GitHub. Não há interface web de pull request, issue ou revisão de código. É um repositório Git comum, com diretório de trabalho (não é um repositório *bare*), hospedado na sua conta e acessado por SSH.
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:
- 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.
- Dentro de SSH Access, clique em Manage SSH Keys.
- Gere uma chave ali (Generate a New Key) ou importe a chave pública que você já usa na sua máquina (Import Key).
- 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.
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:
- 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
.gitdentro, inclusive acessível pela web. Por isso a limpeza manual do passo 2 é obrigatória, não opcional. - No Gerenciador de Arquivos, ative Show Hidden Files (dotfiles) nas configurações, entre em
public_htmle apague a pasta.gitque ficou lá. Confirme antes que o backup do passo anterior está pronto: apagar.gitelimina o histórico daquela cópia. - 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.
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
- Documentação oficial (cpanel) — Guide to Git: Host Git Repositories on a cPanel Account. Consultado em 2026-10-16.