CJDNS-deb

From meshwiki
Jump to: navigation, search

About

CJDNS-deb is a binary Debian/Ubuntu package of Cjdns, formerly maintained by Rainfly X. It used to contain the cjconf suite of conf and utility scripts, but that's been separated into its own package now. It was notable for one-command install.

It was originally created at a time when Cjdns was difficult and inconvenient to compile and install yourself, offering a Debian binary package alternative to the flaky and noob-unfriendly official instructions. It was never an official package, and was eventually made obsolete by improvements to the Cjdns standard compilation/installation workflow, which is fairly simple and stable now. As such, it should be considered an abandoned project, and not used.

Reasons not to use this procedure

The instructions on this page, and the packages that form this install procedure, are not supported by the Cjdns project and are probably not the right way to go about installing Cjdns. It is strongly advised that people interested in installing Cjdns should instead follow the very simple project install guide. There are several reasons to NOT use the below instructions but to instead use the official install instructions:

  1. The Cjdns project is still in a very early alpha phase under exceptionally rapid development. cjd, the author of Cjdns, frequently pushes several updates every day - often including updates which massively improve the features, security, speed, and stability of Cjdns. The below instructions do not incorporate these fixes until the package maintainers get around to it.
  2. The Cjdns project is about security, and the below instructions strip away much of that security by removing the direct access to highly peer-reviewed code behind a third party, unmaintained and little-known mirror.
  3. Cjdns is not at all difficult to install, although it once was. Even novice users not used to building software by hand should not find it terribly difficult to install Cjdns.

So again, please strongly consider avoiding the below instructions, and go to the official page instead.

Step-by-step install

Step by step instructions to get package (historical):

wget http://orchard.crabdance.com/desktop/c/libevent.deb
wget -O cjdns.deb --no-check-certificate https://github.com/campadrenalin/cjdns-deb/raw/master/output/latest/cjdns-i386.deb
wget -O cjconf.deb --no-check-certificate https://github.com/campadrenalin/cjconf/raw/master/output/latest/cjconf.deb
sudo dpkg -i {libevent,cjdns,cjconf}.deb
sudo cjdrouted start-default

Starting the software after the package is installed

This package currently doesn't mess with cron for you or anything. After a reboot, or if you have to stop the router, you may want to start it up again, but don't know how. Simple, the command is:

sudo cjdrouted start

Very similar to the last command in the install script, although that uses a variant that runs cjconf-add-default first to set up default peers in your config file.

Updating the package

You want to download the latest version of the package, and then install it with dpkg -i again. Simple enough. 2 lines of shell:

wget -O cjdns.deb --no-check-certificate https://github.com/campadrenalin/cjdns-deb/raw/master/output/latest/cjdns-i386.deb
wget -O cjconf.deb --no-check-certificate https://github.com/campadrenalin/cjconf/raw/master/output/latest/cjconf.deb
sudo dpkg -i cjdns.deb cjconf.deb