How to Fix 'fatal: not a git repository' Error in Git

The error fatal: not a git repository happens when you run Git commands outside a Git project folder. To fix it, navigate to a folder that contains a .git directory or initialize a new Git repository with git init.

Why This Happens

This error occurs because Git commands expect to run inside a folder that has a .git directory. This directory holds all the information about the Git project. If you run Git commands in a folder without this directory, Git does not know what project you mean, so it shows this error.

bash

cd /some/folder/without/git

git status

Output

fatal: not a git repository (or any of the parent directories): .git

The Fix

To fix this, first check if you are in the right folder. Use cd to go to your project folder that has Git initialized. If your folder is not a Git repository yet, create one by running git init. This command creates the .git directory and makes the folder a Git repository.

bash

cd /path/to/your/project

git init

git status

Output

Initialized empty Git repository in /path/to/your/project/.git/
On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)

Prevention

Always make sure you run Git commands inside a folder that is a Git repository. You can check this by looking for the .git folder or running git status. When starting a new project, run git init early to avoid this error. Using an IDE or code editor that shows Git status can help you avoid running commands in the wrong folder.

Related Errors

Other similar errors include:

• fatal: not a git repository: .git/modules/... — Happens in submodules when paths are broken.
• fatal: could not read from remote repository — Happens when Git cannot access the remote URL.
• fatal: repository not found — Happens when the remote repository URL is wrong or missing.

Quick fixes usually involve checking paths, URLs, and ensuring you are inside a valid Git repository.

Key Takeaways

Run Git commands only inside folders with a .git directory.

Use git init to create a new Git repository if needed.

Check your current folder with cd and ls before running Git commands.

Use git status to verify you are inside a Git repository.

Use tools or editors that show Git status to avoid mistakes.