NAME

       git-annex-p2p - configure peer-2-peer links between repositories

SYNOPSIS

       git annex p2p [options]

DESCRIPTION

       This command can be used to link git-annex repositories over peer-2-peer networks.

       Currently, the only P2P network supported by git-annex is Tor hidden services.

OPTIONS

       --pair

              Run this in two repositories to pair them together over the P2P network.

              This  will  print out a code phrase, like "3-mango-elephant", and will prompt for you to enter the
              code phrase from the other repository.

              Once code phrases have been exchanged, the two repositories will be paired. A git remote  will  be
              created for the other repository, with a name like "peer1".

              This  uses  [Magic  Wormhole](https://github.com/warner/magic-wormhole) to verify the code phrases
              and securely communicate the P2P addresses of the repositories, so you will need it  installed  on
              both computers that are being paired.

              This  feature  was  present in a broken form in git-annex versions before version 6.20180705. Make
              sure that a new enough git-annex is installed on both computers that are being paired.

       --gen-addresses
              Generates addresses that can be used to access this git-annex repository over  the  available  P2P
              networks. The address or addresses is output to stdout.

              Note that anyone who knows these addresses can access your repository over the P2P networks.

              This can be run repeatedly, in order to give different addresses out to different people.

       --link Sets up a git remote that is accessed over a P2P network.

              This  will prompt for an address to be entered; you should paste in the address that was generated
              by --gen-addresses in the remote repository.

              Defaults to making the git remote be named "peer1", "peer2", etc. This can be overridden with  the
              --name option.

       --name Specify a name to use when setting up a git remote with --link or --pair.

       Also the git-annex-common-options(1) can be used.

SEE ALSO

       git-annex(1)

       git-annex-enable-tor(1)

       git-annex-remotedaemon(1)

       wormhole(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                                git-annex-p2p(1)