Untrack Git File

Sep 7th, 2016 - written by Kimserey with .

Last week I had to untrack a file previously pushed on a git repository and I wasn’t sure on how to do it. Took me a while to wrap my head around the process so today I would like to share that in order to have it documented here.

  1. Scenario
  2. git rm --cached
  3. git update-index --assume-unchanged

1. Scenario

I have a file test already pushed in my repository.

1
2
3
> git ls-tree -r master
100644 blob 63123fbe81571b48b7d65602f9828524f9d84b5f	.gitignore
100644 blob a6712f67380bebb75d15c817820e8d2f5c97fb4c	test

Now I wanted to untrack the file from the repository.

2. git rm --cached

If I want to remove the file from the git repository, I can do the following:

1
2
3
> git rm --cached test
> git commit -m "remove test"
> git push

rm is used to remove a file from the index (The index is where the staged changes are held). It would be the same as manually deleting the file and then staging git add . the deletion.

--cached is used to specify that I want to keep my local copy.

Therefore rm --cached test means “remove test from the index but keep my local copy”. And when we execute it, we get the following result:

1
2
3
4
5
6
7
8
9
10
11
12
> git status
On branch master
Your branch is up-to-date with 'origin/master'.
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

	deleted:    test

Untracked files:
  (use "git add <file>..." to include in what will be committed)

	test

As expected, test is deleted and staged - Changes to be committed: 'deleted: test' - and it is removed from the index Untracked files: 'test'. I now need to add test to .gitignore and commit .gitignore it will be removed from the untracked files.

Once you push that, test will be removed from the repository but your local copy will still remain and subsequent changes on the file will not be tracked.

3. git update-index --assume-unchanged

Now let’s say we have another scenario where we actually do not want to remove the file from the repository.

To do that we can do the following:

1
> git update-index --assume-unchanged test

This will tell git that we won’t change the file so no need to track it. The problem with that is that if we change test, our changes won’t be tracked and if the file changes on the remote repository, when trying to pull the latest, it will fail.

In that even, we need to undo the assume-unchanged then undo our changes to be able to pull again.

1
2
3
> git update-index --no-assume-unchanged test
> git checkout test
> git pull

checkout revert the changes on the workspace to the index. If you staged the changes, you will need to use git reset test before to revert the changes staged on index then you can perform git checkout test.

If you need to see what file are assume-unchanged, you can run git ls-files -v.

1
2
3
> git ls-files -v
H .gitignore
h hello

The files assume-unchanged are marked with a small h. If you have a lot of files, you can pipe grep and specify start with h to filter your files.

1
2
> git ls-files -v|grep '^h'
h hello

Conclusion

Today we saw how we could untrack a file previously pushed on a git repository. This was useful for me as I previously held a config file in my repository and needed an easy way to untrack it. Hope you enjoyed reading this post as much as I enjoyed writing it, if you have any comments leave it here or hit me on Twitter @Kimserey_Lam. See you next time!

Designed, built and maintained by Kimserey Lam.