How to Configure Git Locally: Simple Steps for Beginners

To configure Git locally, use the git config command to set your user.name and user.email. These settings identify you in your commits and are stored in your local Git configuration file.

Syntax

The basic syntax to configure Git locally is:

• git config --local user.name "Your Name": Sets your name for commits in the current repository.
• git config --local user.email "[e-mail]": Sets your email for commits in the current repository.

The --local flag means the settings apply only to the current Git repository. If you omit it, Git uses --global by default, which applies settings to all repositories for your user.

bash

git config --local user.name "Your Name"
git config --local user.email "[e-mail]"

Example

This example shows how to set your name and email locally in a Git repository. These details will appear in your commits only in this repository.

bash

git config --local user.name "Alice Johnson"
git config --local user.email "[e-mail]"
git config --local --list

Output

user.name=Alice Johnson
user.email=[e-mail]

Common Pitfalls

Common mistakes when configuring Git locally include:

• Forgetting to set user.email or user.name, which causes Git to warn when committing.
• Setting configuration globally when you want it only for one project.
• Typos in the command or missing quotes around names or emails.

Always check your settings with git config --local --list to confirm.

bash

git config user.name Alice Johnson  # Wrong: missing quotes

# Correct way:
git config --local user.name "Alice Johnson"

Quick Reference

Command	Description
git config --local user.name "Your Name"	Set your name for the current repository
git config --local user.email "[e-mail]"	Set your email for the current repository
git config --local --list	Show all local Git settings
git config --global user.name "Your Name"	Set your name globally for all repositories
git config --global user.email "[e-mail]"	Set your email globally for all repositories

Key Takeaways

Use git config --local to set user name and email only for the current repository.

Always include quotes around your name and email to avoid syntax errors.

Check your local Git configuration with git config --local --list.

Global configuration applies to all repositories; use local config for project-specific settings.

Missing user.name or user.email causes warnings when committing.