Github provides branch “renaming” functionality which can make the process a little easier.

Things to check in a Rails app

  • Capistrano config
  • Circle CI config
  • Github Actions
  • Heroku
  • Any documentation in the repository
  • Any wiki articles in the repository


  • Update Github default branch in repo settings
    • use branch renaming 👍
  • Make sure things don’t break and get everyone to run the git command
  • Update documentation
  • delete master branch

Deployment risks

All users of this repo should run the following command git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main to allow git to point HEAD to the new main branch