41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
|
# cjdns
|
||
|
|
|
||
|
|
[Upstream](README.md)
|
||
|
|
|
||
|
|
#### *Networking Reinvented*
|
||
|
|
|
||
|
|
Cjdns implements an encrypted IPv6 network using public-key cryptography for
|
||
|
|
address allocation and a distributed hash table for routing. This provides
|
||
|
|
near-zero-configuration networking, and prevents many of the security and
|
||
|
|
scalability issues that plague existing networks.
|
||
|
|
|
||
|
|
## Startup
|
||
|
|
|
||
|
|
The key part of cjdns is the cjdroute background daemon. To start cjdroute:
|
||
|
|
|
||
|
|
systemctl start cjdns
|
||
|
|
|
||
|
|
This will generate `/etc/cjdroute.conf` pre-populated with random keys and
|
||
|
|
passwords. At first startup, cjdroute looks for neighboring cjdns peers
|
||
|
|
on all active network interfaces using a layer 2 (e.g. ethernet) protocol.
|
||
|
|
This is exactly what you want if you are on a wifi mesh. If you only have a
|
||
|
|
conventional "clearnet" ISP, see the [upstream](README.md) README for
|
||
|
|
instructions on adding peers using the UDP protocol. (Search for "Find a
|
||
|
|
friend".)
|
||
|
|
|
||
|
|
After adding peers to `/etc/cjdroute.conf`, restart cjdroute with:
|
||
|
|
|
||
|
|
systemctl restart cjdns
|
||
|
|
|
||
|
|
To have cjdroute start whenever you boot, use
|
||
|
|
|
||
|
|
systemctl enable cjdns
|
||
|
|
|
||
|
|
If you are on a laptop and suspend or hibernate it, cjdroute will take a few
|
||
|
|
minutes to make coffee and figure out what just happened when it wakes up. You
|
||
|
|
can speed this up dramatically with:
|
||
|
|
|
||
|
|
systemctl enable cjdns-resume
|
||
|
|
|
||
|
|
The resume service restarts cjdns when the system wakes up from sleep.
|