Removing files from Git Large File Storage

Removing a single file

1. Remove the file from the repository's Git history using either the filter-branch command or BFG Repo-Cleaner. For detailed information on using these, see "Removing sensitive data from a repository."

2. Navigate to your .gitattributes file.

   Note: Your .gitattributes file is generally saved within your local repository. In some cases, you may have created a global .gitattributes file that contains all of your Git LFS associations.

3. Find and remove the associated Git LFS tracking rule within the .gitattributes file.

4. Save and exit the .gitattributes file.

Removing all files within a Git LFS repository

1. Remove the files from the repository's Git history using either the filter-branch command or BFG Repo-Cleaner. For detailed information on using these, see "Removing sensitive data from a repository."

2. Optionally, to uninstall Git LFS in the repository, run:

   $ git lfs uninstall

   For Git LFS versions below 1.1.0, run:

   $ git lfs uninit

Git LFS objects in your repository

After you remove files from Git LFS, the Git LFS objects still exist on the remote storage.

To remove Git LFS objects from a repository, contact your GitHub Enterprise administrator to archive the objects. Archived objects are purged after three months.

Further reading

• "About Git Large File Storage"
• "Collaboration with Git Large File Storage"
• "Installing Git Large File Storage"