Sentry Answers>Git>

Delete a file from a Git repository

Delete a file from a Git repository

David Y.

The ProblemJump To Solution

How do I delete a file from a Git repository?

The Solution

We can do this using git rm:

Click to Copy
git rm unwanted-file.txt

This command will delete the file and stage its deletion to be included in the next commit. If we want to remove a directory, we must include the -r (recursive) flag, as with the standard rm command.

If we want only to stage the file’s deletion without also deleting it from our local filesystem, we can use the --cached flag:

Click to Copy
git rm --cached unwanted-file.txt

Note that any files removed this way will still be visible in previous commits. If the file we want to remove contains sensitive content, we will need either to create a new Git repository with a fresh history or to rewrite the history of our current repository using git filter-branch:

Click to Copy
git filter-repo -f --index-filter 'git rm --cached --ignore-unmatch unwanted-file.txt'

Note that rewriting the commit history in this way is dangerous and will permanently alter your repository. Additionally, git filter-branch is a slow operation, especially for large repositories with many commits. Double-check that the name of the file to be removed is correct before running this command.

After our commit history has been rewritten, we will need to force push the changes to remote repositories using a command such as the following:

Click to Copy
git push --force -u origin main
  • ResourcesWhat is Distributed Tracing
  • logo
    Listen to the Syntax Podcast

    Tasty treats for web developers brought to you by Sentry. Get tips and tricks from Wes Bos and Scott Tolinski.


Loved by over 4 million developers and more than 100,000 organizations worldwide, Sentry provides code-level observability to many of the world’s best-known companies like Disney, Peloton, Cloudflare, Eventbrite, Slack, Supercell, and Rockstar Games. Each month we process billions of exceptions from the most popular products on the internet.

© 2024 • Sentry is a registered Trademark
of Functional Software, Inc.