Alterar o remote do URL

Neste artigo

• Alternar URLs remotes de SSH para HTTPS
• Alternar URLs remotes de HTTPS para SSH
• Solução de Problemas
• Leia mais

O comando git remote set-url usa dois argumentos:

• Um nome remote existente. Por exemplo, origin ou upstream são duas escolhas comuns.

• Uma nova URL para o remote. Por exemplo:

  • Se estiver atualizando para usar HTTPS, a URL poderá ser parecida com esta:

    https://[hostname]/USERNAME/REPOSITORY.git

  • Se estiver atualizando para usar SSH, a URL poderá ser parecida com esta:

    git@hostname:USERNAME/REPOSITORY.git

Alternar URLs remotes de SSH para HTTPS

1. Open TerminalTerminalGit Bash.

2. Altere o diretório de trabalho atual referente ao seu projeto local.

3. Liste seus remotes existentes para obter o nome do remote que deseja alterar.

   $ git remote -v
   > origin  git@hostname:USERNAME/REPOSITORY.git (fetch)
   > origin  git@hostname:USERNAME/REPOSITORY.git (push)

4. Altere a URL do remote de SSH para HTTPS com o comando git remote set-url.

   $ git remote set-url origin https://hostname/USERNAME/REPOSITORY.git

5. Verifique se o URL remote foi alterado.

   $ git remote -v
   # Verifica a nova URL do remote
   > origin  https://hostname/USERNAME/REPOSITORY.git (fetch)
   > origin  https://hostname/USERNAME/REPOSITORY.git (push)

Na próxima vez que você aplicar git fetch, git pull ou git push no repositório remote, precisará fornecer seu nome de usuário e a senha do GitHub.

• Se você tiver habilitado a autenticação de dois fatores, precisará criar um token de acesso pessoal para ser usado no lugar da senha do GitHub.
• Você pode usar um auxiliar de credenciais para que o Git se lembre do seu nome de usuário e da sua senha do GitHub sempre que ele conversar com o GitHub.

Alternar URLs remotes de HTTPS para SSH

1. Open TerminalTerminalGit Bash.

2. Altere o diretório de trabalho atual para seu projeto local.

3. Liste seus remotes existentes para obter o nome do remote que deseja alterar.

   $ git remote -v
   > origin  https://hostname/USERNAME/REPOSITORY.git (fetch)
   > origin  https://hostname/USERNAME/REPOSITORY.git (push)

4. Altere a URL do remote de HTTPS para SSH com o comando git remote set-url.

   $ git remote set-url origin git@hostname:USERNAME/REPOSITORY.git

5. Verifique se o URL remote foi alterado.

   $ git remote -v
   # Verifica a nova URL do remote
   > origin  git@hostname:USERNAME/REPOSITORY.git (fetch)
   > origin  git@hostname:USERNAME/REPOSITORY.git (push)

Solução de Problemas

Você pode se deparar com os seguintes erros ao tentar alterar um remote:

No such remote '[name]'

Este erro informa que o remote que você tentou alterar não existe:

$ git remote set-url sofake https://hostname/octocat/Spoon-Knife
> fatal: No such remote 'sofake'

Verifique se você inseriu corretamente o nome do remote.

Leia mais

• "Trabalhar com remotes" no livro Pro Git