702

.gitconfig is usually stored in the user.home directory.

I use a different identity to work on projects for Company A and something else for Company B (primarily the name / email). How can I have two different Git configurations so that my check-ins don't go with the name / email?

15 Answers 15

657

As of git version 2.13, git supports conditional configuration includes. In this example we clone Company A's repos in ~/company_a directory, and Company B's repos in ~/company_b.

At the end of your .gitconfig file, you can put something like this:

[includeIf "gitdir:~/company_a/"]
  path = .gitconfig-company_a
[includeIf "gitdir:~/company_b/"]
  path = .gitconfig-company_b

Example contents of .gitconfig-company_a (the [core] section can be omitted if the global ssh key can be used):

[user]
name = John Smith
email = [email protected]

[core]
sshCommand = ssh -i ~/.ssh/id_rsa_companya

Example contents of .gitconfig-company_b:

[user]
name = John Smith
email = [email protected]

[core]
sshCommand = ssh -i ~/.ssh/id_rsa_companyb
9
  • 2
    It's great to see this has been added in version 2.13. I have been using github.com/bddenhartog/git-profiles for awhile, but couldn't get it to work with Tower.
    – adrum
    Commented May 11, 2017 at 19:02
  • 5
    includeIf is a little finicky, see: stackoverflow.com/questions/43919191/…
    – rouble
    Commented May 22, 2017 at 18:15
  • 11
    I just want to note that the gitdir folder must end with slash (/), otherwise git would ignore the ignoreIf config (actually, it would result in false). Commented Dec 21, 2019 at 17:32
  • 37
    Do note that the directory-specific configuration will only take effect inside a repository as a subdirectory (example ~/company_a/repo_1). If you're in a non-repository directory like ~/company_a and run git config user.email you'll still get the global email address. Don't let that confuse you.
    – ADTC
    Commented Jun 17, 2021 at 3:57
  • 3
    it's also worth mentioning that if one wants to preserve some defaults in the .gitconfig and only apply, let's say a different email for that particular dir, the includeif clause should be added at the end of it. If added at the beginning and the same properties are specified afterwards, they will be overridden and won't have any effect.
    – dimisjim
    Commented Aug 2, 2022 at 9:08
594

There are 3 levels of git config; project, global and system.

  • local: Project configs are only available for the current project and stored in .git/config in the project's directory.
  • global: Global configs are available for all projects for the current user and stored in ~/.gitconfig.
  • system: System configs are available for all the users/projects and stored in /etc/gitconfig.

Create a project specific config, you can either execute this under the project's directory:

$ git config user.name "John Doe" 

Or, explicitly:

$ git config --local user.name "John Doe" 

Create a global config:

$ git config --global user.name "John Doe"

Create a system config:

$ git config --system user.name "John Doe" 

And as you may guess, project overrides global and global overrides system.

Note: Project configs are local to just one particular copy/clone of this particular repo, and need to be reapplied if the repo is recloned clean from the remote. It changes a local file that is not sent to the remote with a commit/push.

10
  • 164
    Is there is a possibility to make some "directory" config? I do some job at home and got folders with work projects and my own. So I got folders ~/job and ~/my with git repos and want different configs for projects under them. E.g. job/project1 has config from job/.gitconfig. Commented Apr 8, 2016 at 18:41
  • 7
    @Serge did you ever figure out if it was possible to create a directory level config? I have the same issue right now. Commented Jun 13, 2018 at 14:11
  • 2
    No I set overall system config to personal data and make bash script to set job data to certain project configs in one command. Commented Jun 14, 2018 at 14:28
  • 3
    As an addendum: just git config user.name or git config user.email will show you the name or email Git will use for the current respository. Commented Mar 11, 2019 at 8:24
  • 6
    @theprogrammer Did you guys ever try this out? It works for me. stackoverflow.com/a/43884702/5383834
    – Wit
    Commented Apr 29, 2020 at 10:56
397

The .git/config file in a particular clone of a repository is local to that clone. Any settings placed there will only affect actions for that particular project.

(By default, git config modifies .git/config, not ~/.gitconfig - only with --global does it modify the latter.)

0
110

Thanks @crea1

A small variant:

As it is written on https://git-scm.com/docs/git-config#_includes:

If the pattern ends with /, ** will be automatically added. For example, the pattern foo/ becomes foo/**. In other words, it matches foo and everything inside, recursively.

So I use in my case,
~/.gitconfig :

[user] # as default, personal needs
    email = [email protected]
    name = bcag2
[includeIf "gitdir:~/workspace/"] # job needs, like workspace/* so all included projects
    path = .gitconfig-job

# all others section: core, alias, log…

So If the project directory is in my ~/wokspace/, default user settings is replace with
~/.gitconfig-job :

[user]
name = John Smith
email = [email protected]
6
  • Done this , now correct user name and email is set in different directories . When I do git config user.name / git config user.email I get correct details . But when I comment in personal repo , it always picks up global official username email
    – Bhupendra
    Commented Oct 9, 2019 at 6:33
  • @Bhupendra In my sample, .gitconfig and .gitconfig-job is in my home, not in project directories. Do you need more than two ? Have you create a .gitconfig-alternativ in your home directory, as my .gitconfig-job in my sample, with 3 lines.
    – bcag2
    Commented Oct 11, 2019 at 6:42
  • @bcag2 I too followed the same example given above. I have 2 configs work the default one and personal similar to gitconfig-job. When I am in the personal directory, on git config user.name gives me correct name but for pushing the commit it takes the default one whereas I need the personal one. Commented Jan 13, 2020 at 16:54
  • @swapnil2993 first I think at path issue but if git config user.name return correct one, it should be ok. Are you under GNU/Linux or other OS?
    – bcag2
    Commented Jan 14, 2020 at 7:35
  • 1
    A note on this: If you need the file path to be case-insensitive replace gitdir with gitdir/i. Example: [includeIf "gitdir/i:~/workspace/"]
    – mskolnick
    Commented Sep 25, 2021 at 13:43
37

To be explicit, you can also use --local to use current repository config file:

git config --local user.name "John Doe" 

Or as @SherylHohman mentioned, use the following to open the local file in your editor:

git config --local --edit
1
  • 1
    and if you do git config --local --edit it will create/open the local file for you so you can edit directly. This was important for me because for some unknown reason neither VSCode, nor my XYPlorer file explorer would show my .git folder (though other dot files and system files show, and traditionally my file explorer does show my .git folder if I want it to.) For my case it was much easier to edit the file directly than add several options via the command line. Commented Dec 19, 2021 at 19:56
21

Another way is to use direnv and to separate config files per directory. For example:

.
├── companyA
│  ├── .envrc
│  └── .gitconfig
├── companyB
│  ├── .envrc
│  └── .gitconfig
└── personal
   ├── .envrc
   └── .gitconfig

Each .envrc should contain something like this:

export GIT_CONFIG_GLOBAL=$(pwd)/.gitconfig

And .gitconfig is the usual gitconfig with desired values.

This is what I have in the custom .gitconfig files:

[include]
    path = ~/.gitconfig

[user]
    email = [email protected]
    signingKey = XXXXXXXXXXXXXXXX

Here only user.email is overwritten, the rest configuration is taken from the default ~/.gitconfig.

1
19

I am doing this for my email in the following way:

git config --global alias.hobbyprofile 'config user.email "[email protected]"'

Then when I clone a new work project, I have only to run git hobbyprofile and it will be configured to use that email.

1
  • How to change the username as well?
    – hardik9850
    Commented Oct 28, 2023 at 8:45
14

You can also point the environment variable GIT_CONFIG to a file that git config should use. With GIT_CONFIG=~/.gitconfig-A git config key value the specified file gets manipulated.

5
  • 3
    Cool; with a bit of clever shell magic this can be used to set things up so git picks the first .gitconfig it finds when traversing the dir tree up above current repo. Thanks!
    – ecmanaut
    Commented Mar 20, 2013 at 17:30
  • 1
    Do you have a link to this shell magic that does this? Sounds useful!
    – pchiusano
    Commented Dec 5, 2013 at 19:46
  • 1
    @pchiusano here's a rudimentary version of it in fish github.com/CtrlC-Root/dotfiles/blob/master/.config/fish/…
    – ctrlc-root
    Commented Mar 10, 2015 at 20:51
  • it only affect git config command now github.com/git/git/blob/master/Documentation/RelNotes/…
    – foray1010
    Commented Jan 23, 2020 at 15:44
  • for Git v2.32.0 and newer, use GIT_CONFIG_GLOBAL. Example: GIT_CONFIG_GLOBAL=~/.gitconfig-another git commit -m "foo"
    – Abdull
    Commented Aug 30, 2023 at 9:09
4

You can customize a project's Git config by changing the repository specific configuration file (i.e. /path/to/repo/.git/config). BTW, git config writes to this file by default:

cd /path/to/repo
git config user.name 'John Doe'  # sets user.name locally for the repo

I prefer to create separate profiles for different projects (e.g. in ~/.gitconfig.d/) and then include them in the repository's config file:

cd /path/to/repo
git config include.path '~/.gitconfig.d/myproject.conf'

This works well if you need to use the same set of options in multiple repos that belong to a single project. You can also set up shell aliases or a custom Git command to manipulate the profiles.

3

Add multiple SSH keys with Github config

After 13 August 2021, git is not supporting HTTPs authentication method, so I believe this answer needs to be updated.

Follow the steps below:

  • remove all SSH keys (public & private) for Git stored in directory ~/.ssh/.
  • create new SSH keys:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
ssh-keygen -t rsa -b 4096 -C "[email protected]"

When asked for file names, give default ~/.ssh/id_rsa for account1 and ~/.ssh/id_rsa_acc2 for account2 respectively.

  • Start ssh-agent and add private keys for account1 and account2:
eval `ssh-agent`
ssh-add -k ~/.ssh/id_rsa
ssh-add -k ~/.ssh/id_rsa_acc2

confirm keys are added by command ssh-add -l

  • copy public keys for account1 and account2 and add it to your github account. command: cat ~/.ssh/id_rsa.pub | pbcopy (to check whether its copied: pbpaste

  • set account1's username and user email as global GitHub config:

git config --global user.name "acc1_username"
git config --global user.email "[email protected]"
  • create ~/.ssh/config file with following configuration:
# account1 github
Host github.com
HostName github.com
User git
AddKeysToAgent yes
IdentityFile ~/.ssh/id_rsa

# account2 github
Host github.com-acc2
HostName github.com
User git
AddKeysToAgent yes
IdentityFile ~/.ssh/id_rsa_acc2
  • To set GitHub account2 for a project set username & email on project level in the project root directory:
git config user.name "acc2_username"
git config user.email "[email protected]"
  • Now clone or add origin by using SSH link of GitHub repo:
# for account1 repo
git remote set-url origin [email protected]:acc1_username/reponame.git

# for account2 repo
git clone [email protected]:acc2_username/reponame.git

Feel free to add comments for any doubts.

0
1

Follow the Steps:

  1. Find .gitconfig from the system

    File Location For Windows : "C:\Users${USER_NAME}.gitconfig"

    File Location For Linux : "/usr/local/git/etc/gitconfig"

  2. Open .gitconfig file and add below lines as per your condition

     [includeIf "gitdir:D:\ORG-A-PROJECTS\"]
    
     [user]
    
         name = John Smith
    
         email = [email protected] [includeIf "gitdir:~/organization_b/"]
    
     [user]
    
         name = John Doe
    
         email = [email protected]
    
1
  • wrong file location for Linux, especially for ubuntu 18 or 20, there is no git folder in /usr/local/ !
    – bcag2
    Commented Mar 12, 2021 at 7:22
1

Found out a really useful shell script wrapping over all the process of ssh key generation and typing out long commands again and again

Note: This is only for ZSh users

https://github.com/tw-yshuang/Git_SSH-Account_Switch

0

I'm in the same boat. I wrote a little bash script to manage them. https://github.com/thejeffreystone/setgit

#!/bin/bash

# setgit
#
# Script to manage multiple global gitconfigs
# 
# To save your current .gitconfig to .gitconfig-this just run:
# setgit -s this
#
# To load .gitconfig-this to .gitconfig it run:
# setgit -f this
# 
# 
# 
# Author: Jeffrey Stone <[email protected]>

usage(){
  echo "$(basename $0) [-h] [-f name]" 
  echo ""
  echo "where:"
  echo " -h  Show Help Text"
  echo " -f  Load the .gitconfig file based on option passed"
  echo ""
  exit 1  
}

if [ $# -lt 1 ]
then
  usage
  exit
fi

while getopts ':hf:' option; do
  case "$option" in
      h) usage
         exit
         ;;
      f) echo "Loading .gitconfig from .gitconfig-$OPTARG"
         cat ~/.gitconfig-$OPTARG > ~/.gitconfig
         ;;
      *) printf "illegal option: '%s'\n" "$OPTARG" >&2
         echo "$usage" >&2
         exit 1
         ;;
    esac
done
1
  • Your script here is in Bash, while on Github you have Python version. Also -s is not handled in your Bash script. Commented Apr 20, 2018 at 13:31
0

I had an error when trying to git stash my local changes. The error from git said "Please tell me who you are" and then told me to "Run git config --global user.email "[email protected] and git config --global user.name "Your name" to set your account's default identity." However, you must Omit --global to set the identity only in your current repository.

0

If anyone having trouble with this using Windows then do this:

Edit file %USERPROFILE%\.gitconfig and add these lines for each company you want to have specific settings for

[includeIf "gitdir:C:\\!work\\company_X\\"]

[user]    
     name = Some Guy    
     email = [email protected] 

[includeIf "gitdir:C:\\!work\\company_Y\\"]

[user]    
     name = Some Other Guy    
     email = [email protected] 

That worked for me.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.