Kalana
Kalana

Reputation: 6173

What is the difference between global and local configuration in git?

I am a beginner to Git. I go through the internet and find those.

What I know are

Can I know any other differences between these configurations?

Upvotes: 51

Views: 50779

Answers (4)

MrTux
MrTux

Reputation: 34042

Git uses a hierarchical config approach in which settings of a broader scope are inherited if not overriden.

On the top level is the system config (all users, usually in /etc/git), then there is the global config (which can override system defaults with personal ones, located in the home directory of the user, e.g. $HOME/.gitconfig or $HOME/.config/git/config) and finally there is the local config for a repository (.git/config in the repository root) which can override all above and set repository specific options.

All configuration files have the same syntax, but a different scope.

This offers a lot of flexibility.

Upvotes: 38

Lior
Lior

Reputation: 1

Just a little note, as opposed to other comments mentioned here, typing "git config --list" will output hybrid config values and not only local config. In other words, the default of "git config --list" in a project is not --local

Upvotes: 0

Zahid Khan
Zahid Khan

Reputation: 3287

Git comes with a tool called git config that lets you configure variables that control all the aspects of how git will operate.

git config holds its value between upgrades. So, you need to set it only once.

Basically, there are 3 places to store these variables:

  1. System.
  2. Global.
  3. Local.

1. System: These variables are available for every user in the system and stored in

[path]/etc/gitconfig.
Example: C:/Program Files/Git/etc/gitconfig

You can make git read and write from System by passing --system as option. It also requires you to have administration permissions.


2. Global: Global configurations are available for the current user for all the projects and stored in

~/.gitconfig or ~/.config/git/config
Example: C:/Users/Username/.gitconfig

You can make git to read and write from Global by passing --global option.


3. Local: Local configs are available for the current repository only and stored in

[gitrepo]/.git/config
Example: C:/Users/MyProject/.git/config

You can make git read and write from Local by passing --local option.


Example:

Create a local config
$ git config --local user.name "Local User"

# Create a global config
$ git config --global user.name "Global User"

# Create a system config
$ sudo git config --system user.name "System User"

to verify the origin of your configuration :

git config --list --show-origin

Also, its important to remember each level overrides values the previous level.

Priority:

Local > Global > System

Upvotes: 58

shrikant1712
shrikant1712

Reputation: 4446

Local level configuration is applied to the context repository git config gets invoked in. Local configuration values are stored in a file that can be found in the repo's .git directory: .git/config. If you don’t specify which level you want to work with, this is the default.

Whereas, global configuration values are stored in a file that is located in a user's home directory. ~ /.gitconfig on Unix systems and C:\Users\<username>\.gitconfig on windows

Upvotes: 8

Related Questions