git-annex-initremote(1)      General Commands Manual     git-annex-initremote(1)

       git-annex-initremote - creates a special (non-git) remote

       git annex initremote name type=value [param=value ...]

       Creates a new special remote, and adds it to .git/config.

       Example Amazon S3 remote:

        git annex initremote mys3 type=S3 encryption=hybrid

       Many different types of special remotes are supported by git-annex.  For
       a list and details, see <https://git->

       The remote's configuration is specified by the parameters passed to this
       command. Different types of special remotes need different configuration
       values. The command will prompt for parameters as needed.

       All special remotes support encryption. You can specify encryption=none
       to disable encryption, or specify encryption=hybrid keyid=$keyid ... to
       specify a GPG key id (or an email address associated with a key). For
       details about ways to configure encryption, see <https://git->

       If you anticipate using the new special remote in other clones of the
       repository, you can pass "autoenable=true". Then when git-annex-init(1)
       is run in a new clone, it will attempt to enable the special remote. Of
       course, this works best when the special remote does not need anything
       special to be done to get it enabled.

       Normally, git-annex generates a new UUID for the new special remote.  If
       you want to, you can specify a UUID for it to use, by passing a
       uuid=whatever parameter. This can be useful in some situations, eg when
       the same data can be accessed via two different special remote backends.
       But if in doubt, don't do this.


              When initializing a remote that uses encryption, a cryptographic
              key is created. This requires sufficient entropy. If initremote
              seems to hang or take a long time while generating the key, you
              may want to Ctrl-c it and re-run with --fast, which causes it to
              use a lower-quality source of randomness. (Ie, /dev/urandom
              instead of /dev/random)



       Joey Hess <>