2015-11-16 20:31:26 +00:00
|
|
|
git-lfs-install(1) -- Install Git LFS configuration.
|
|
|
|
========================================================
|
|
|
|
|
|
|
|
## SYNOPSIS
|
|
|
|
|
|
|
|
`git lfs install` [options]
|
|
|
|
|
|
|
|
## DESCRIPTION
|
|
|
|
|
|
|
|
Perform the following actions to ensure that Git LFS is setup properly:
|
|
|
|
|
|
|
|
* 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,
|
2016-08-01 22:15:07 +00:00
|
|
|
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.
|
2015-11-16 20:31:26 +00:00
|
|
|
|
|
|
|
## OPTIONS
|
|
|
|
|
|
|
|
Without any options, `git lfs install` will only setup the "lfs" smudge and clean
|
|
|
|
filters if they are not already set.
|
|
|
|
|
|
|
|
* `--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
|
2016-04-26 06:26:02 +00:00
|
|
|
config, instead of the global git config (~/.gitconfig).
|
2020-06-16 01:26:48 +00:00
|
|
|
* `--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.
|
2017-07-11 16:40:01 +00:00
|
|
|
* `--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.
|
2016-04-26 06:26:02 +00:00
|
|
|
* `--system`:
|
|
|
|
Sets the "lfs" smudge and clean filters in the system git config, e.g. /etc/gitconfig
|
|
|
|
instead of the global git config (~/.gitconfig).
|
2015-11-16 20:31:26 +00:00
|
|
|
* `--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.
|
2017-01-16 12:39:55 +00:00
|
|
|
* `--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.
|
2015-11-16 20:31:26 +00:00
|
|
|
|
|
|
|
## SEE ALSO
|
|
|
|
|
2020-06-16 01:26:48 +00:00
|
|
|
git-lfs-uninstall(1), git-worktree(1).
|
2015-11-16 20:31:26 +00:00
|
|
|
|
|
|
|
Part of the git-lfs(1) suite.
|