Skip to content

Commit 19538dd

Browse files
committed
Add concrete steps in doc/cjdns.md to easily find a friend
1 parent 9e32adb commit 19538dd

File tree

1 file changed

+25
-5
lines changed

1 file changed

+25
-5
lines changed

doc/cjdns.md

+25-5
Original file line numberDiff line numberDiff line change
@@ -23,17 +23,37 @@ somewhat centralized. I2P connections have a source address and I2P is slow.
2323
CJDNS is fast but does not hide the sender and the recipient from intermediate
2424
routers.
2525

26-
## Installing CJDNS and connecting to the network
26+
## Installing CJDNS and finding a peer to connect to the network
2727

2828
To install and set up CJDNS, follow the instructions at
2929
https://github.com/cjdelisle/cjdns#cjdns.
3030

31-
Don't skip steps
31+
You need to initiate an outbound connection to a peer on the CJDNS network
32+
before it will work with your Bitcoin Core node. This is described in steps
3233
["2. Find a friend"](https://github.com/cjdelisle/cjdns#2-find-a-friend) and
3334
["3. Connect your node to your friend's
34-
node"](https://github.com/cjdelisle/cjdns#3-connect-your-node-to-your-friends-node).
35-
You need to be connected to the CJDNS network before it will work with your
36-
Bitcoin Core node.
35+
node"](https://github.com/cjdelisle/cjdns#3-connect-your-node-to-your-friends-node)
36+
in the CJDNS documentation.
37+
38+
One quick way to accomplish these two steps is to query for available public
39+
peers on [Hyperboria](https://github.com/hyperboria) by running the following:
40+
41+
```
42+
git clone https://github.com/hyperboria/peers hyperboria-peers
43+
cd hyperboria-peers
44+
./testAvailable.py
45+
```
46+
47+
For each peer, the `./testAvailable.py` script prints the filename of the peer's
48+
credentials followed by the ping result.
49+
50+
Choose one or several peers, copy their credentials from their respective files,
51+
paste them into the relevant IPv4 or IPv6 "connectTo" JSON object in the
52+
`cjdroute.conf` file you created in step ["1. Generate a new configuration
53+
file"](https://github.com/cjdelisle/cjdns#1-generate-a-new-configuration-file),
54+
and save the file.
55+
56+
## Launching CJDNS
3757

3858
Typically, CJDNS might be launched from its directory with
3959
`sudo ./cjdroute < cjdroute.conf` and it sheds permissions after setting up the

0 commit comments

Comments
 (0)