git-annex-drop man page

git-annex-drop — remove content of files from repository


git annex drop [path ...]


Drops the content of annexed files from this repository, when possible.

git-annex will refuse to drop content if it cannot verify it is safe to do so.



Rather than dropping the content of files in the local repository, this option can specify a remote from which the files' contents should be removed.


Rather than trying to drop all specified files, drop only files that are not preferred content of the repository. See git-annex-preferred-content(1)


Use this option with care! It bypasses safety checks, and forces git-annex to delete the content of the specified files, even from the last repository that is storing their content. Data loss can result from using this option.

--all -A

Rather than specifying a filename or path to drop, this option can be used to drop all available versions of all files.

This is the default behavior when running git-annex drop in a bare repository.

Note that this bypasses checking the .gitattributes annex.numcopies setting.


Drop files in the specified branch or treeish.

Note that this bypasses checking the .gitattributes annex.numcopies setting.


Drop files found by last run of git-annex unused.

Note that this bypasses checking the .gitattributes annex.numcopies setting.


Use this option to drop a specified key.

Note that this bypasses checking the .gitattributes annex.numcopies setting.

file matching options

The git-annex-matching-options(1) can be used to specify files to drop.

--jobs=N -JN

Runs multiple drop jobs in parallel. This is particularly useful when git-annex has to contact remotes to check if it can drop files. For example: -J4  


Enables batch mode, in which lines containing names of files to drop are read from stdin.

As each specified file is processed, the usual output is displayed. If a file's content is not present, or it does not match specified matching options, or it is not an annexed file, a blank line is output in response instead.


Enable JSON output. This is intended to be parsed by programs that use git-annex. Each line of output is a JSON object.


Messages that would normally be output to standard error are included in the json instead.

See Also






Joey Hess <>

Referenced By

git-annex(1), git-annex-copy(1), git-annex-get(1), git-annex-move(1).