Skip to content

repository/large-files

Checks that each tracked file over the size limit goes through Git LFS or has a reason.

Part of the repository configuration, at the recommended level. It runs at the commit stage, once for the repository. gspot runs this check itself.

A large file in plain Git history stays in every clone forever.

Track the file with Git LFS, classify it as generated or vendored in .gitattributes, or raise repository.max_file_kilobytes with a reason.

A tracked notes/big.txt of 1,100 KiB, over the default limit of 1,024, reports size. Delete the file, or store it through Git LFS.

Turn it off for some files, with a reason:

gspot ignore repository/large-files --paths "<glob>" --reason "<why>"