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

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

João Rizzon · 2026-10-17 · Painéis

---

## 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](https://docs.cpanel.net/knowledge-base/web-services/guide-to-git-host-git-repositories-on-a-cpanel-account/), 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.yml` no 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 usuario@seudominio.com.br
```

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://usuario@seudominio.com.br: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://usuario@seudominio.com.br: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 `.git` dentro, 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_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.
- 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.

