1git-annex-init(1)           General Commands Manual          git-annex-init(1)
2
3
4

NAME

6       git-annex-init - initialize git-annex
7

SYNOPSIS

9       git annex init [description]
10

DESCRIPTION

12       Until  a  repository (or one of its remotes) has been initialized, git-
13       annex will refuse to operate on it, to avoid accidentally using it in a
14       repository that was not intended to have an annex.
15
16       It's  useful,  but  not  mandatory,  to  initialize each new clone of a
17       repository with its own description. If you don't provide one, one will
18       be generated using the username, hostname and the path.
19
20       If  any special remotes were configured with autoenable=true, this will
21       also attempt to enable them. See git-annex-initremote(1).   To  prevent
22       that,  re-enable  a  remote with "autoenable=false", or mark it as dead
23       (see git-annex-dead(1)).
24
25       This command is entirely safe, although usually pointless, to  run  in‐
26       side an already initialized git-annex repository.
27
28       A  top-level  .noannex file will prevent git-annex init from being used
29       in a repository. This is useful for repositories  that  have  a  policy
30       reason  not to use git-annex. The content of the file will be displayed
31       to the user who tries to run git-annex init.
32

EXAMPLES

34        # git annex add foo
35        git-annex: First run: git-annex init
36        # git annex init
37        init ok
38        # git annex add foo
39        add foo ok
40

OPTIONS

42       --version=N
43
44              Force the repository to be initialized  using  a  different  an‐
45              nex.version than the current default.
46
47              When  the  version given is one that automatically upgrades to a
48              newer version, it will automatically use the newer  version  in‐
49              stead.
50
51       --autoenable
52              Only  enable  any  special remotes that were configured with au‐
53              toenable=true, do not otherwise initialize anything.
54
55       Also the git-annex-common-options(1) can be used.
56

SEE ALSO

58       git-annex(1)
59
60       git-annex-describe(1)
61
62       git-annex-reinit(1)
63
64       git-init(1)
65

AUTHOR

67       Joey Hess <id@joeyh.name>
68
69                                                             git-annex-init(1)
Impressum