{"id":84,"date":"2026-01-18T18:55:45","date_gmt":"2026-01-18T18:55:45","guid":{"rendered":"https:\/\/balamurali.in\/blog\/?p=84"},"modified":"2026-02-23T14:25:47","modified_gmt":"2026-02-23T14:25:47","slug":"how-to-manage-multiple-github-accounts-on-one-machine-the-pain-free-way","status":"publish","type":"post","link":"https:\/\/balamurali.in\/blog\/learn-with-me\/how-to-manage-multiple-github-accounts-on-one-machine-the-pain-free-way\/","title":{"rendered":"How to Manage Multiple GitHub Accounts on One Machine (The Pain-Free Way)"},"content":{"rendered":"\n

If you are like most developers, you probably have two lives: your day job and your side hustles.<\/p>\n\n\n\n

This usually means you have two GitHub accounts:<\/p>\n\n\n\n

    \n
  1. A Work Account<\/strong> (e.g., specific to your organization)<\/li>\n\n\n\n
  2. A Personal Account<\/strong> (for your open-source contributions and hobby projects)<\/li>\n<\/ol>\n\n\n\n

    The problem arises when you try to use both on the same laptop. You might push code to a personal repo only to realize later that the commit author is your work email. Even worse, you might encounter “Permission Denied” or “Repository Not Found” errors because Git is trying to authenticate your work repo using your personal SSH key.<\/p>\n\n\n\n

    Manually switching SSH keys or configuring local git settings for every single repository is tedious and prone to error.<\/p>\n\n\n\n

    In this post, I\u2019ll show you a “set it and forget it” folder management strategy that automatically switches your Git identity and SSH keys based on where your project lives.<\/p>\n\n\n\n

    The Goal: Zero Manual Intervention<\/h2>\n\n\n\n

    By the end of this guide, your workflow will look like this:<\/p>\n\n\n\n

      \n
    • Any project inside ~\/Work\/<\/code> automatically uses your Work Identity<\/strong> and Work SSH Key<\/strong>.<\/li>\n\n\n\n
    • Any project inside ~\/Personal\/<\/code> automatically uses your Personal Identity<\/strong> and Personal SSH Key<\/strong>.<\/li>\n\n\n\n
    • You can clone using HTTPS or SSH, and it will just work.<\/li>\n<\/ul>\n\n\n\n

      Step 1: Organize Your Directory Structure<\/h2>\n\n\n\n

      The secret sauce here is folder-based configuration<\/strong>. To make this work, you need to separate your projects physically on your disk.<\/p>\n\n\n\n

      Create two distinct directories:<\/p>\n\n\n\n

      mkdir ~\/Personal\nmkdir ~\/Work<\/code><\/pre>\n\n\n\n
      Move your existing projects into the appropriate folders.<\/p>\n\n\n\n
      Step 2: Generate Separate SSH Keys<\/h2>\n\n\n\n
      If you haven’t already, generate unique SSH keys for each account.<\/p>\n\n\n\n
      # Generate Personal Key\nssh-keygen -t rsa -b 4096 -C \"your-personal-email@example.com\" -f ~\/.ssh\/id_rsa_personal\n\n# Generate Work Key\nssh-keygen -t rsa -b 4096 -C \"your-work-email@company.com\" -f ~\/.ssh\/id_rsa_work<\/code><\/pre>\n\n\n\n
      Once generated, add the public keys<\/strong> (.pub<\/code> files) to the respective GitHub accounts under Settings > SSH and GPG keys<\/strong>.<\/p>\n\n\n\n
      Step 3: Configure SSH Config<\/h2>\n\n\n\n
      Now, tell your computer which key to use for which “host alias.” Edit your ~\/.ssh\/config<\/code> file:<\/p>\n\n\n\n
      # Personal Account\nHost github.com-personal\n    HostName github.com\n    User git\n    IdentityFile ~\/.ssh\/id_rsa_personal\n    IdentitiesOnly yes\n\n# Work Account\nHost github.com-work\n    HostName github.com\n    User git\n    IdentityFile ~\/.ssh\/id_rsa_work\n    IdentitiesOnly yes<\/code><\/pre>\n\n\n\n
      Note: The Host<\/code> value here acts as an alias we will use in the next step.<\/em><\/p>\n\n\n\n
      Step 4: The Magic of .gitconfig<\/code> IncludeIf<\/h2>\n\n\n\n
      This is the most critical part. Instead of putting all your settings in one global .gitconfig<\/code> file, we will split them up using the [includeIf]<\/code> directive.<\/p>\n\n\n\n
      Open your main global config (~\/.gitconfig<\/code>) and add this:<\/p>\n\n\n\n
      [user]\n    # Default global user (fallback)\n    email = default@example.com\n    name = Default Name\n\n[includeIf \"gitdir:~\/Personal\/\"]\n    path = ~\/.gitconfig-personal\n\n[includeIf \"gitdir:~\/Work\/\"]\n    path = ~\/.gitconfig-work<\/code><\/pre>\n\n\n\n
      This tells Git: “If I am inside the ~\/Personal\/<\/code> folder, load the extra settings from .gitconfig-personal<\/code>.”<\/em><\/p>\n\n\n\n
      Step 5: Create the Specific Config Files<\/h2>\n\n\n\n
      Now, create the two specific configuration files referenced above.<\/p>\n\n\n\n
      ~\/.gitconfig-personal<\/code><\/h3>\n\n\n\n
      This file ensures that any repo in your personal folder uses your personal email and automatically maps URLs to the correct SSH key alias.<\/p>\n\n\n\n
      [user]\n    name = Your Personal Name\n    email = your-personal-email@example.com\n\n# Auto-rewrite URLs to use the specific SSH alias<\/code><\/pre>\n\n\n
      [url “git@github.com-personal:”]<\/p>\n\n\n\n
      insteadOf = git@github.com: insteadOf = https:\/\/github.com\/<\/p>\n\n\n\n
      ~\/.gitconfig-work<\/code><\/h3>\n\n\n\n
      Do the same for your work profile.<\/p>\n\n\n\n
      [user]\n    name = Your Work Name\n    email = your-work-email@company.com\n\n# Auto-rewrite URLs to use the specific SSH alias<\/code><\/pre>\n\n\n
      [url “git@github.com-work:”]<\/p>\n\n\n\n
      insteadOf = git@github.com: insteadOf = https:\/\/github.com\/<\/p>\n\n\n\n
      How It Works Under the Hood<\/h2>\n\n\n\n
      The magic lies in the [url \"...\"] insteadOf<\/code> block.<\/p>\n\n\n\n
      When you run git push<\/code> inside ~\/Work\/ProjectA<\/code>:<\/p>\n\n\n\n
        \n
      1. Git sees the includeIf<\/code> matches ~\/Work\/<\/code>.<\/li>\n\n\n\n
      2. It loads .gitconfig-work<\/code>.<\/li>\n\n\n\n
      3. It sets your author email to your work address.<\/li>\n\n\n\n
      4. If you cloned the repo using https:\/\/github.com\/org\/repo.git<\/code> or git@github.com:org\/repo.git<\/code>, Git automatically rewrites the remote URL to git@github.com-work:org\/repo.git<\/code>.<\/li>\n\n\n\n
      5. The SSH config sees github.com-work<\/code> and uses id_rsa_work<\/code>.<\/li>\n<\/ol>\n\n\n\n
        Summary Table<\/h2>\n\n\n\n
        Here is a quick breakdown of how the environment handles your data:<\/p>\n\n\n\n
        Folder Location<\/th>Git User Identity<\/th>SSH Key Used<\/th><\/tr><\/thead>
        ~\/Personal\/*<\/code><\/td>Personal Name & Email<\/td>id_rsa_personal<\/code><\/td><\/tr>
        ~\/Work\/*<\/code><\/td>Work Name & Email<\/td>id_rsa_work<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        Conclusion<\/h2>\n\n\n\n
        By spending 10 minutes setting this up, you save yourself from:<\/p>\n\n\n\n
          \n
        • Accidentally committing to work repos with a personal email.<\/li>\n\n\n\n
        • Debugging SSH permission errors.<\/li>\n\n\n\n
        • Having to manually configure git config user.email<\/code> for every new repository you clone.<\/li>\n<\/ul>\n\n\n\n
          Just drag your project into the right folder, and Git handles the rest!<\/p>\n","protected":false},"excerpt":{"rendered":"
          If you are like most developers, you probably have two lives: your day job and your side hustles. This usually means you have two GitHub accounts: The problem arises when…<\/p>\n","protected":false},"author":1,"featured_media":145,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[8],"tags":[],"class_list":["post-84","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-learn-with-me"],"jetpack_featured_media_url":"https:\/\/balamurali.in\/blog\/wp-content\/uploads\/2026\/02\/github_multiple_accounts.png","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/posts\/84","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/comments?post=84"}],"version-history":[{"count":1,"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/posts\/84\/revisions"}],"predecessor-version":[{"id":86,"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/posts\/84\/revisions\/86"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/media\/145"}],"wp:attachment":[{"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/media?parent=84"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/categories?post=84"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/balamurali.in\/blog\/wp-json\/wp\/v2\/tags?post=84"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}