Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

There are two basic options for starting up your own d3ck - either from the source or by using either a raspberry pi image or EC2 AMI (both running Ubuntu Linux) that I've created that has all the stuff baked in.

I've mostly tested the server software on Ubuntu, but I have tried other distros and they seem to work fine, it seems to mostly be a distro packaging thing.

Where to get

  1. github:

  2. Amazon EC2:


  3. Raspberry Pi bootable disk image:

This is based on a fresh install of the NOOBS/Raspbian distro from RPi land itself. It has all the stuff you should need (other than the raspberry pi itself) to get rolling easily. The 'sudo' enabled login & password for the Pi are:

login:       pi
password:  d3ck

SSHD is enabled.

Getting it on

*** If you've downloaded a binary, ensure you have the latest by simply typing:

cd /etc/d3ck

git pull

More on installing via source below, but once you do get it going, or are using either of the binary images above, you should be able to start it by:

sudo service d3ck start

Lots of output will (should!) result, and when the shell prompt finally returns it should be ready to go (a quick connect to https: to your d3ck on port 8080 with a browser should tell you whether or not that's true.

Installing from source/github

*** For god's sake don't try this out on a production system, as it'll *** mangle things (hopefully nothing bad) you might not want on something *** you actually care about.

ALSO - you need up-to-date versions of nginx (1.4+), OpenVPN, and really want fairly modern versions for the rest. I'll put version checking in eventually.....

A d3ck runs on Linux; ubuntu is great, you can try others assuming they have fairly modern packages. First, get the source:

git clone

cd d3ck

There's also a variety of packages needed to run this thing.

One of the most important ones is a recent version of nodejs. You can download pre-built binaries for various operating systems from You need be running >= nodejs version .12++.

Some nice [](details for the Raspberry Pi.)

I found some nice instructions for Linux (Centos, but worked on Ubuntu) here.

Here are some additional packages that should be installed for an Ubuntu-like system:

sudo apt-get update  # probably wise :)

sudo apt-get install -y python-software-properties openssh-server openvpn yate nginx openssl git ntp npm redis-server curl

Then all the myriad node dependencies:

npm install

Almost there; the next step should be done as root (the d3ck assumes it'll be in /etc/d3ck) - this installs a few scripts and creates links to various things:

sudo ./

And, if by some miracle all of that worked, you can start up your d3ck:

sudo service d3ck start

This will take some time the first time it's run, as it'll be generating keys. On a t1.micro EC2 instance it takes anywhere from a couple of minutes to 20 or so (it's a non-deterministic process to generate the DH key.)

It's all done when the user prompt is showing again (it'll be running in the background.)