Setup a Cjdns Node

This guide will help you set up a cjdns node on a server.

The easiest way to get a cjdns node installed is using cjdns.sh.

Requirements

A server running debian based Linux (preferably Ubuntu 22.04).

Steps

1. Determine your Peer ID.

To get your Peer ID, first register your cjdns node on the PKT Dashboard.

2. Install cjdns.sh

curl https://pkt.cash/special/cjdns/cjdns.sh | CJDNS_PEERID=<peer-id-goes-here> sh

3. Check if you have peers working

cjdnstool peers show

4. Make sure your firewall is open.

Port 3478 must be accessible from the public internet.

iptables-save
nft list ruleset

5. Check the tester

Your node should appear on The Cjdns Peer Tester.

  • It should appear within 5 minutes of being started, and should bt tested after 10.
  • It will be identified by its Peer ID.
  • OK means your node passed the test, ConnectTimeout means your node could not be reached.

6. Wait for the dashboard to update

After the tester has approved your node, the dashboard should update soon after. When the dashboard shows green, your node is all set to begin yielding.

Different public port

If you can't expose port 3478 to the public, you can change the port by specifying CJDNS_PORT=<port number> when installing cjdns.

More information

To learn more, check out https://github.com/cjdelisle/cjdns.sh