Como Conectar Repositórios

Última atualização em 30 de maio de 2025

Você pode conectar o repositório com o código da sua aplicação à nossa App Platform ao criar um novo app no painel de controle da Hostman.

A App Platform é compatível com repositórios GitHub, GitLab e Bitbucket, além de repositórios acessíveis via URL, como Gitea, GitLab self-hosted, GitHub Enterprise, entre outros.

Conectar um repositório do GitLab, GitHub ou Bitbucket
Copiar link

Para conectar o repositório:

  1. Acesse a seção Plataforma de apps e clique em Criar aplicativo.
  2. Na etapa Repositório, clique no ícone da plataforma.

Image1

  1. Faça login na sua conta.
  2. Autorize o acesso aos repositórios necessários.
  3. Selecione o repositório para fazer o deploy na dashboard da Hostman.

Se você já estiver logado na sua conta do GitHub, GitLab ou Bitbucket, a Hostman exibirá automaticamente os repositórios disponíveis. Basta selecionar o desejado.

Se estiver logado mas o repositório necessário não aparecer:

  1. Clique em Adicionar conta.
  2. Escolha a plataforma.
  3. Faça login, se necessário.
  4. Selecione os repositórios desejados e salve as alterações.

Depois, selecione o repositório desejado para o deploy na dashboard da Hostman.

Conectar um repositório via URL
Copiar link

Você pode conectar qualquer repositório com um endereço externo HTTP ou HTTPS, incluindo repositórios do GitLab self-hosted, GitHub Enterprise ou provedores que não oferecemos suporte direto (ex: Gitea).

Essa opção também pode ser usada por motivos de segurança: se você não quiser fornecer acesso à conta Git inteira, é possível adicionar apenas o repositório específico por link.

Atenção: o deploy automático não estará disponível para repositórios conectados via URL. Após atualizar o código, será necessário fazer o deploy manualmente, escolhendo o commit.

Para repositórios públicos, basta informar a URL.

Para repositórios privados, você deverá fornecer login e senha da conta ou um token gerado na interface do provedor (GitLab, GitHub etc.).

Conectar um repositório
Copiar link

Você pode conectar o repositório por URL ao criar uma nova aplicação:

  1. Acesse a seção Plataforma de apps e clique em Criar aplicativo.
  2. Na etapa Repositório, clique em Conectar repositório via URL.
  3. Informe a URL do repositório e os dados de acesso, caso seja privado.
  4. Clique em Conectar.

O repositório e os commits disponíveis serão exibidos no painel de controle.

Obter link git
Copiar link

O link deve estar no formato Git URL, por exemplo:

https://github.com/hostman/app-example.git

No GitHub, clique em Code → HTTPS para obter o link.

No GitLab ou BitBucket: vá até o repositório desejado → clique em Code/Clone → Clone with HTTPS..

Obter link e token no BitBucket
Copiar link

  1. Vá em Account settings → Security → API Tokens. 
  2. Clique em Create API Token with scopes.
  3. Defina o nome e validade do token. Clique em Next.
  4. Selecione Bitbucket e clique em Next.
  5. Selecione read:repository:bitbucket e clique em Next.
  6. Clique em Create token.
  7. Copie o token e cole no campo Password or token na dashboard da Hostman.
  8. Vá até o repositório e clique em Clone. Copie tudo após git clone e cole no campo Repository URL.
  9. Copie a parte do link entre https:// e @ e cole no campo Username.

Obter token no GitHub
Copiar link

Você não poderá conectar um repositório do GitHub usando apenas a senha da conta — é necessário gerar um token.

Para gerar um token no GitHub:

  1. Acesse Settings → Developer Settings → Personal access tokens → Tokens → Generate a personal access token.
  2. Defina o nome, validade e permissões do token. Para acessar repositórios privados, marque a opção repo.

Ff398dec 0574 429b B03b 83d82255b920

Geração de token pessoal na interface do GitHub

  1. Clique em Generate token.
  2. Copie o token e cole no campo Password or token da dashboard da Hostman.

Obter token no GitLab
Copiar link

Para conectar repositórios do GitLab, é possível usar sua senha ou um token gerado nas configurações da conta GitLab.

  1. Acesse Preferences → Access Tokens.
  2. Crie um novo token informando nome, validade e permissões. Permissões de leitura para repositórios são suficientes.
  3. Clique em Create personal access token.
  4. Copie o token e cole no campo Password or token na dashboard da Hostman.

Remover repositórios conectados
Copiar link

Qualquer repositório adicionado pode ser desvinculado da App Platform.

  1. Acesse a seção Plataforma de apps e clique em Criar aplicativo.
  2. Na etapa Repositório, clique na lista suspensa de repositórios e depois em Excluir ao lado do que deseja remover.
  3. Confirme a ação.

Troubleshooting
Copiar link

A App Platform não mostra o repositório necessário
Copiar link

Se sua conta do GitHub, GitLab ou Bitbucket estiver conectada à App Platform, mas o repositório necessário não for exibido no painel da Hostman, pode haver duas causas:

  • Você adicionou o repositório após ter feito login na conta do GitHub, GitLab ou Bitbucket na App Platform.
  • Você autorizou acesso apenas a alguns repositórios, e o necessário não está entre eles.

Para corrigir:

  1. Acesse a seção Plataforma de apps e clique em Criar aplicativo.
  2. Na etapa Repositório, clique em Adicionar conta.
  3. Escolha a plataforma.
  4. Faça login, se necessário.
  5. Selecione o repositório desejado e salve as alterações.

Os repositórios conectados aparecerão no painel da Hostman e você poderá escolher o que precisa.