NAME

       git-annex-config - configuration stored in git-annex branch

SYNOPSIS

       git annex config --set name value

       git annex config --get name

       git annex config --unset name

DESCRIPTION

       Set or get configuration settings stored in the git-annex branch.

       Unlike  git  config  settings, these settings can be seen in all clones of the repository,
       once they have gotten their git-annex branches in sync.

       These settings can be overridden on a per-repository basis using git config.

       git-annex does not check the git-annex branch for all the git config settings that  affect
       it  (which  are  listed  on the git-annex man page CONFIGURATION section). Only a few make
       sense to be able to set such that all clones of a repository see the setting, and so  git-
       annex only looks for these.

SUPPORTED SETTINGS

       annex.largefiles

              Used  to configure which files are large enough to be added to the annex.  It is an
              expression that matches the large files, eg "include=*.mp3  or  largerthan(500kb)".
              See git-annex-matching-expression(1) for details on the syntax.

              This  sets  a  default,  which  can be overridden by annex.largefiles attributes in
              .gitattributes files, or by git config.

       annex.dotfiles
              Normally, dotfiles are assumed to be files like .gitignore,  whose  content  should
              always  be  part  of  the  git  repository, so they will not be added to the annex.
              Setting annex.dotfiles to true makes dotfiles be added to the annex the same as any
              other file.

              This sets a default, which can be overridden by annex.dotfiles in git config.

       annex.addunlocked
              Commands  like  git-annex  add  default to adding files to the repository in locked
              form. This can make them add the files in  unlocked  form,  the  same  as  if  git-
              annex-unlock(1) were run on the files.

              This  can  be  set  to  "true"  to  add  everything  unlocked,  or it can be a more
              complicated expression that matches files by  name,  size,  or  content.  See  git-
              annex-matching-expression(1) for details.

              This sets a default, which can be overridden by annex.addunlocked in git config.

       annex.autocommit
              Set   to  false  to  prevent  the  git-annex  assistant  and  git-annex  sync  from
              automatically committing changes to files in the repository.

       annex.resolvemerge
              Set  to  false  to  prevent  merge  conflicts  in  the  checked  out  branch  being
              automatically  resolved by the git-annex assitant, git-annex sync, git-annex merge,
              and the git-annex post-receive hook.

       annex.synccontent
              Set to true to make git-annex sync default to syncing annexed content.

       annex.synconlyannex
              Set to true to make git-annex sync default to only sincing the git-annex branch and
              annexed content.

       annex.securehashesonly
              Set  to  true  to  indicate  that  the repository should only use cryptographically
              secure hashes (SHA2, SHA3) and not insecure hashes (MD5, SHA1) for content.

              When this is set, the contents of files  using  cryptographically  insecure  hashes
              will not be allowed to be added to the repository.

              Also,  git-annex  fsck will complain about any files present in the repository that
              use insecure hashes.

              Note that this is only read from the git-annex branch by git  annex  init,  and  is
              copied  to  the  corresponding git config setting.  So, changes to the value in the
              git-annex branch won't affect a repository once it has been initialized.

EXAMPLE

       Suppose you want to prevent git annex sync from committing changes to files, so  a  manual
       git commit workflow is used in all clones of the repository. Then run:

        git annex config --set annex.autocommit false

       If you want to override that in a partiticular clone, just use git config in the clone:

        git config annex.autocommit true

       And to get back to the default behavior:

        git annex config --unset annex.autocommit

SEE ALSO

       git-annex(1)

       git-config(1)

       git-annex-vicfg(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                              git-annex-config(1)