Scroll to navigation

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

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.
--gen-address
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.
--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-address 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.

SEE ALSO

git-annex(1)

git-annex-enable-tor(1)

git-annex-remotedaemon(1)

wormhole(1)

AUTHOR

Joey Hess <id@joeyh.name>