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

NAME

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

SYNOPSIS

9       git annex p2p [options]
10

DESCRIPTION

12       This   command   can  be  used  to  link  git-annex  repositories  over
13       peer-2-peer networks.
14
15       Currently, the only P2P network supported by git-annex  is  Tor  hidden
16       services.
17

OPTIONS

19       --pair
20
21              Run  this in two repositories to pair them together over the P2P
22              network.
23
24              This will print out a code phrase, like "3-mango-elephant",  and
25              will  prompt  for  you  to  enter the code phrase from the other
26              repository.
27
28              Once code phrases have been exchanged, the two repositories will
29              be  paired.  A  git remote will be created for the other reposi‐
30              tory, with a name like "peer1".
31
32              This uses [Magic Wormhole](https://github.com/warner/magic-worm
33              hole)  to  verify  the code phrases and securely communicate the
34              P2P addresses of the repositories, so you will need it installed
35              on both computers that are being paired.
36
37              This  feature was present in a broken form in git-annex versions
38              before version 6.20180705. Make sure that a new enough git-annex
39              is installed on both computers that are being paired.
40
41       --gen-addresses
42              Generates  addresses  that  can be used to access this git-annex
43              repository over the available P2P networks. The address  or  ad‐
44              dresses is output to stdout.
45
46              Note  that  anyone  who  knows  these  addresses can access your
47              repository over the P2P networks.
48
49              This can be run repeatedly, in order to give different addresses
50              out to different people.
51
52       --link Sets up a git remote that is accessed over a P2P network.
53
54              This  will prompt for an address to be entered; you should paste
55              in the address that was generated by --gen-addresses in the  re‐
56              mote repository.
57
58              Defaults  to  making  the  git remote be named "peer1", "peer2",
59              etc. This can be overridden with the --name option.
60
61       --name Specify a name to use when setting up a git remote  with  --link
62              or --pair.
63
64       Also the git-annex-common-options(1) can be used.
65

SEE ALSO

67       git-annex(1)
68
69       git-annex-enable-tor(1)
70
71       git-annex-remotedaemon(1)
72
73       wormhole(1)
74

AUTHOR

76       Joey Hess <id@joeyh.name>
77
78                                                              git-annex-p2p(1)
Impressum