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
44              addresses is output to stdout.
45
46              Note  that  anyone  who  knows  these  addresses can access your
47              repository over the P2P networks.
48
49       --link Sets up a git remote that is accessed over a P2P network.
50
51              This will prompt for an address to be entered; you should  paste
52              in  the  address  that  was  generated by --gen-addresses in the
53              remote repository.
54
55              Defaults to making the git remote  be  named  "peer1",  "peer2",
56              etc. This can be overridden with the --name option.
57
58       --name Specify  a  name to use when setting up a git remote with --link
59              or --pair.
60

SEE ALSO

62       git-annex(1)
63
64       git-annex-enable-tor(1)
65
66       git-annex-remotedaemon(1)
67
68       wormhole(1)
69

AUTHOR

71       Joey Hess <id@joeyh.name>
72
73                                                              git-annex-p2p(1)
Impressum