1git-annex-init(1) General Commands Manual git-annex-init(1)
2
3
4
6 git-annex-init - initialize git-annex
7
9 git annex init [description]
10
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
26 inside 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
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
42 --version=N
43
44 Force the repository to be initialized using a different
45 annex.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
49 instead.
50
51 --autoenable
52 Only enable any special remotes that were configured with
53 autoenable=true, do not otherwise initialize anything.
54
56 git-annex(1)
57
58 git-annex-describe(1)
59
60 git-annex-reinit(1)
61
62 git-init(1)
63
65 Joey Hess <id@joeyh.name>
66
67 git-annex-init(1)