Installing & Configuring Git

Step 1: Check If Git Is Already Installed

Before installing Git, let's check if it's already on your system. Many computers, especially Macs and Linux machines, come with Git pre-installed.

Open Your Terminal/Command Prompt

First, you need to open a command-line interface:

• Windows: Search for "Command Prompt" or "PowerShell" in the Start menu
• Mac: Open "Terminal" from Applications → Utilities, or press Cmd + Space and type "Terminal"
• Linux: Press Ctrl + Alt + T or search for "Terminal" in your applications

Check the Git Version

In your terminal, type this command and press Enter:

git --version

You'll see one of two results:

git version 2.43.0

'git' is not recognized as an internal or external command

Installing Git on Windows

Windows doesn't include Git by default, but installation is straightforward.

Method 1: Official Git for Windows (Recommended)

1. Download the installer: Go to git-scm.com/download/win and the download should start automatically
2. Run the installer: Double-click the downloaded .exe file
3. Follow the installation wizard: You'll see many options—here are the recommended settings:

4. Complete the installation: Click "Install" and wait for it to finish
5. Verify installation: Open a new Command Prompt or PowerShell window and run:

git --version

You should see the Git version number!

Method 2: Using Package Managers

If you use Windows package managers, you can also install Git through:

• Chocolatey: choco install git
• Winget: winget install Git.Git

Installing Git on macOS

macOS usually includes an older version of Git, but we recommend installing a newer version.

Method 1: Using Homebrew (Recommended)

Homebrew is a popular package manager for Mac that makes installing developer tools easy.

1. Install Homebrew (if you don't have it):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install Git using Homebrew:

brew install git

3. Verify installation:

git --version

Method 2: Official Git Installer

1. Download the installer from git-scm.com/download/mac
2. Open the .dmg file and follow the instructions
3. Verify installation in Terminal with git --version

Method 3: Xcode Command Line Tools

Installing Xcode Command Line Tools will also install Git:

xcode-select --install

A popup will appear—click "Install" and agree to the license terms.

Installing Git on Linux

Most Linux distributions make it easy to install Git using their package manager.

Debian/Ubuntu

# Update package list
sudo apt update

# Install Git
sudo apt install git

# Verify installation
git --version

Fedora

# Install Git
sudo dnf install git

# Verify installation
git --version

Arch Linux

# Install Git
sudo pacman -S git

# Verify installation
git --version

CentOS/RHEL

# Install Git
sudo yum install git

# Verify installation
git --version

Step 2: Configure Your Identity

Now that Git is installed, you need to configure it with your name and email. This information is attached to every commit you make, so others know who made which changes.

Set Your Name

This should be your real name or the name you want associated with your work:

git config --global user.name "Your Name"

Replace "Your Name" with your actual name, for example:

git config --global user.name "Sarah Johnson"

Set Your Email

Use the email address associated with your GitHub account (if you created one):

git config --global user.email "your.email@example.com"

For example:

git config --global user.email "sarah.johnson@example.com"

Understanding --global

The --global flag means these settings apply to all Git repositories on your computer. You only need to do this once!

If you ever need different settings for a specific project, you can omit --global and run the commands inside that project's directory.

Step 3: Verify Your Configuration

Let's make sure everything is set up correctly.

Check Specific Settings

View your configured name:

git config --global user.name

View your configured email:

git config --global user.email

View All Configuration

See all your Git settings at once:

git config --list

This will show something like:

user.name=Sarah Johnson
user.email=sarah.johnson@example.com
core.editor=code --wait
init.defaultbranch=main
...

Step 4: Additional Useful Configuration

While name and email are required, here are some other settings that will improve your Git experience:

Set Default Branch Name to "main"

Modern Git uses "main" as the default branch name instead of "master":

git config --global init.defaultBranch main

Set Your Preferred Text Editor

Git will open a text editor for commit messages. Set your preferred editor:

# For Visual Studio Code
git config --global core.editor "code --wait"

# For Nano (simple terminal editor)
git config --global core.editor "nano"

# For Vim
git config --global core.editor "vim"

# For Sublime Text
git config --global core.editor "subl -n -w"

Enable Helpful Colors

Make Git output more readable with colors (usually enabled by default):

git config --global color.ui auto

Set Up Line Ending Handling

This helps prevent issues when working with people on different operating systems:

# For Windows
git config --global core.autocrlf true

# For Mac/Linux
git config --global core.autocrlf input

Step 5: Set Up Credential Helper (Optional but Recommended)

Without a credential helper, Git will ask for your GitHub username and password every time you push or pull. Let's fix that!

For Windows

If you installed Git for Windows, the credential manager is already set up. Verify with:

git config --global credential.helper

You should see manager-core or manager.

For macOS

Use the built-in Keychain credential helper:

git config --global credential.helper osxkeychain

For Linux

Set up the cache credential helper:

# Store credentials for 1 hour
git config --global credential.helper cache

# Or store credentials for longer (e.g., 10 hours)
git config --global credential.helper 'cache --timeout=36000'

Understanding Configuration Levels

Git has three levels of configuration:

1. System Level (All Users)

git config --system

Applies to all users on the computer. Rarely used and requires admin privileges.

2. Global Level (Your User)

git config --global

Applies to all your repositories. This is what we've been using and is the most common level.

3. Local Level (One Repository)

git config --local

Applies only to the current repository. Used when you need different settings for a specific project.

Local settings override global settings, and global settings override system settings.

Editing Configuration File Directly (Advanced)

If you prefer, you can edit the configuration file directly instead of using commands:

# Open global config in your default editor
git config --global --edit

This opens your global config file (usually located at ~/.gitconfig on Mac/Linux or C:\Users\YourName\.gitconfig on Windows).

The file looks like this:

[user]
    name = Sarah Johnson
    email = sarah.johnson@example.com
[core]
    editor = code --wait
[init]
    defaultBranch = main
[color]
    ui = auto

You can edit this file manually, but using git config commands is safer for beginners.

Troubleshooting Common Issues

Issue: Command Not Found

Issue: Permission Denied

Issue: Editor Won't Close

Issue: Wrong Name or Email

git config --global user.name "Correct Name"
git config --global user.email "correct.email@example.com"

Testing Your Installation

Let's verify everything is working correctly with a few commands:

All commands should work without errors!

Useful Configuration Commands

Here's a quick reference of common config commands:

# View all configuration
git config --list

# View configuration with file origins
git config --list --show-origin

# Get a specific setting
git config user.name

# Set a value
git config --global user.name "Your Name"

# Unset (remove) a value
git config --global --unset user.name

# Edit configuration file directly
git config --global --edit

# Get help on configuration
git config --help

What You Can Do Now

With Git installed and configured, you're ready to start using it! Here's a preview of what's coming:

• Create repositories: Initialize Git in your projects
• Make commits: Save snapshots of your work
• View history: See all the changes you've made over time
• Create branches: Try different ideas safely
• Connect to GitHub: Share your work and collaborate

In the next lesson, we'll create your first Git repository and make your first commit!

Key Takeaways

What's Next?

Congratulations! You've successfully installed and configured Git. You now have everything you need to start tracking your projects.

In the next lesson, we'll create your very first Git repository, make some changes, and create your first commits. You'll see Git in action and start building your understanding of the commit workflow!