NAME

SYNOPSIS

DESCRIPTION

• Set up the clean and smudge filters under the name "lfs" in the global Git config.
• Install a pre-push hook to run git-lfs-pre-push(1) for the current repository, if run from inside one. If "core.hooksPath" is configured in any Git configuration (and supported, i.e., the installed Git version is at least 2.9.0), then the pre-push hook will be installed to that directory instead.

OPTIONS

--force

Sets the "lfs" smudge and clean filters, overwriting existing values.

--local

Sets the "lfs" smudge and clean filters in the local repository´s git config, instead of the global git config (~/.gitconfig).

--worktree

Sets the "lfs" smudge and clean filters in the current working tree´s git config, instead of the global git config (~/.gitconfig) or local repository´s git config ($GIT_DIR/config). If multiple working trees are in use, the Git config extension worktreeConfig must be enabled to use this option. If only one working tree is in use, --worktree has the same effect as --local. This option is only available if the installed Git version is at least 2.20.0 and therefore supports the "worktreeConfig" extension.

--manual

Print instructions for manually updating your hooks to include git-lfs functionality. Use this option if git lfs install fails because of existing hooks and you want to retain their functionality.

--system

Sets the "lfs" smudge and clean filters in the system git config, e.g. /etc/gitconfig instead of the global git config (~/.gitconfig).

--skip-smudge

Skips automatic downloading of objects on clone or pull. This requires a manual "git lfs pull" every time a new commit is checked out on your repository.

--skip-repo

Skips setup of the local repo; use if you want to install the global lfs filters but not make changes to the current repo.

SEE ALSO

Part of the git-lfs(1) suite.