How to Configure Git Username and Email Address


2 min read

Set Git Username and Email Address

Git is a distributed version control system that’s being used by most software teams today. The first thing you should do after installing Git on your system is to configure your git username and email address. Git associate your identity with every commit you make.

Git allows you to set a global and per-project username and email address. You can set or change your git identity using the git config command. Changes only affect future commits. The name and email associated with the commits you made prior to the change are not affected.

Setting Global Git Username and Email

The global git username and email address are associated with commits on all repositories on your system that don’t have repository-specific values.

To set your global commit name and email address run the git config command with the --global option:

git config --global "Your Name"git config --global ""

Once done, you can confirm that the information is set by running:

git config --list Name

The command saves the values in the global configuration file, ~/.gitconfig:

    name = Your Name
    email =

You can also edit the file with your text editor, but it is recommended to use the git config command.

Setting Git Username and Email for a Single Repository

If you want to use a different username or email address for a specific repository, run the git config command without the --global option from within the repository directory.

Let’s say you want to set a repository-specific username and email address for a stored in the ~/Code/myapp directory. First, switch the repository root directory:

cd ~/Code/myapp

Set a Git username and email address:

git config "Your Name"git config ""

Verify that the changes were made correctly:

git config --list Name

The repository-specific setting are kept in the .git/config file under the root directory of the repository.


The Git username and email address can be set with the git config command. The values are associated with your commits.

If you are new to Git, read the Pro Git book , which is an excellent resource for learning about how to use Git.

Leave a comment below if you hit a problem or have feedback.