How to Exclude Local Files from Git Repositories Using .gitignore

Sometimes, you need certain files in your local project but don’t want them to be included in the remote repository. The solution is to use a .gitignore file, which allows you to specify files that should remain local. This guide will show you how to create and use a .gitignore file effectively.

Banner

When working on a project, there are times when you want some files to exist only on your local machine and not be pushed to the remote repository. This could include configuration files, temporary scripts, logs, or environment-specific settings.

The best way to prevent Git from tracking such files is by using the .gitignore file. Creating and Using a .gitignore File

To create a .gitignore file, run the following command in your terminal:


touch .gitignore

Then, open the file using a text editor:


vim .gitignore

Now, you can list the files you want to ignore. For example:


myConfig.conf
test.py
node_modules/ 
logs/
.env

Applying the .gitignore File

Once you’ve added the necessary file names to .gitignore, stage and commit the changes:


git add .gitignore
git commit -m "Added .gitignore file"
git push

Optional: Removing Previously Tracked Files

If you have already tracked some files that should be ignored, Git won’t automatically remove them just because they are now in .gitignore. To untrack them, use:


git rm --cached <file_path>

For example:


git rm --cached myConfig.conf

Then commit and push the changes:


git commit -m "Removed myConfig.conf from tracking"
git push

With .gitignore, you can keep your repository clean and ensure that only necessary files are shared while keeping local-specific files safe. 🚀

How to Exclude Local Files from Git Repositories Using .gitignore | Software Engineer Blog