DEV Community 👩‍💻👨‍💻

Otu Michael
Otu Michael

Posted on • Updated on

Change branch name from master to main

By google-ing, we'd find a simple command as git branch -m master main which should rename the master branch to main.

What if it was not successful and you had,

error: refname refs/heads/master not found
fatal: Branch rename failed
Enter fullscreen mode Exit fullscreen mode

Well, in my case, I create a new project then I initialized git. I then remembered that by default, on Github, the default branch is main and not master anymore.

You can change the name from master to main in few steps, locally before you even make a commit.

  1. Navigate to the directory where your project sits.
  2. In it, show hidden file since by default, .git would be hidden.
  3. Inside .git, there is a file, HEAD, open it in a text editor. You'd see, ref: refs/heads/master.
  4. Simple enough, change, master to main.

We just renamed the master branch as main. Verify this merely by entering, git branch from the terminal.

In an instance where the project is new locally (the project is git initialized locally), then after the first commit, git add . && git commit -m "Initial commit" we can rename the current branch with, git branch -m main`.

Top comments (3)

Collapse
256hz profile image
Abe Dolinger

This helped a ton, thank you!

Collapse
juniormayhe profile image
Junior Mayhé

I don't know ghana languages but here we go: meda wo ase!

Collapse
otumianempire profile image
Otu Michael Author

You are welcome 😘😘

👋 Welcome new DEV members in our Welcome Thread

Say hello to the newest members of DEV.