.TH git-annex-init 1
.SH NAME
git-annex-init \- initialize git-annex
.PP
.SH SYNOPSIS
git annex init \fB[description]\fP
.PP
.SH DESCRIPTION
Until a repository (or one of its remotes) has been initialized,
git-annex will refuse to operate on it, to avoid accidentally
using it in a repository that was not intended to have an annex.
.PP
It's useful, but not mandatory, to initialize each new clone
of a repository with its own description. If you don't provide one,
one will be generated using the username, hostname and the path.
.PP
If any special remotes were configured with autoenable=true,
this will also attempt to enable them. See git-annex\-initremote(1).
To prevent that, re\-enable a remote with "autoenable=false", or
mark it as dead (see git-annex\-dead(1)).
.PP
This command is entirely safe, although usually pointless, to run inside an
already initialized git-annex repository.
.PP
A top\-level \fB.noannex\fP file will prevent git-annex init from being used
in a repository. This is useful for repositories that have a policy
reason not to use git-annex. The content of the file will be displayed
to the user who tries to run git-annex init.
.PP
.SH EXAMPLES
 # git annex add foo
 git-annex: First run: git-annex init
 # git annex init
 init ok
 # git annex add foo
 add foo ok
.PP
.SH OPTIONS
.IP "\fB\-\-version=N\fP"
.IP
Force the repository to be initialized using a different annex.version
than the current default.
.IP
When the version given is not supported, but can be automatically
upgraded to a newer version, it will use the newer version instead.
.IP
.IP "\fB\-\-autoenable\fP"
Only enable any special remotes that were configured with
autoenable=true, do not otherwise initialize anything.
.IP
.IP "\fB\-\-no\-autoenable\fP"
Do not enable special remotes that were configured with autoenable=true.
.IP
.IP "\fB\-\-json\fP"
Enable JSON output. This is intended to be parsed by programs that use
git-annex.
.IP
.IP "\fB\-\-json\-error\-messages\fP"
Messages that would normally be output to standard error are included in
the JSON instead.
.IP
.IP "Also the git-annex\-common\-options(1) can be used."
.SH SEE ALSO
git-annex(1)
.PP
git-annex\-describe(1)
.PP
git-annex\-reinit(1)
.PP
git\-init(1)
.PP
.SH AUTHOR
Joey Hess <id@joeyh.name>
.PP
.PP