Rename Remote Branch

GitGitBeginner
Practice Now

This tutorial is from open-source community. Access the source code

Introduction

In Git, a branch is a lightweight movable pointer to a commit. Renaming a branch is a common task in Git. However, renaming a branch both locally and on the remote can be a bit tricky. In this challenge, you will learn how to rename a remote branch in Git.


Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL git(("`Git`")) -.-> git/CollaborationandSharingGroup(["`Collaboration and Sharing`"]) git/CollaborationandSharingGroup -.-> git/remote("`Manage Remotes`") subgraph Lab Skills git/remote -.-> lab-12666{{"`Rename Remote Branch`"}} end

Rename Remote Branch

To complete this challenge, you will use the Git repository git-playground from your GitHub account, which comes from a fork of https://github.com/labex-labs/git-playground.git. Please uncheck "Copy master branch only" when forking.

You have a Git repository named https://github.com/your-username/git-playground. You have created a branch named feature-branch and pushed it to the remote. Now you want to rename the branch to new-feature-1 both locally and on the remote.

Tasks

  1. Clone the repository, navigate to the directory and configure the identity.
  2. Switch to the named feature-branch branch.
  3. Rename the branch both locally and on the remote.
  4. Verify that the branch has been renamed.

This is the result of running git branch -a:

* master
new-feature-1
remotes/origin/HEAD - > origin/master
remotes/origin/master
remotes/origin/new-feature-1

Summary

Renaming a remote branch in Git involves renaming the branch both locally and on the remote. You can use the git branch -m <old-name> <new-name> command to rename the local branch and the git push origin --delete <old-name> and git push origin -u <new-name> commands to delete the old remote branch and set the new remote branch, respectively.

Other Git Tutorials you may like