Handshake logo
 \/\::/  /
   /:/  / 

Linux Install Guide

The Handshake software suite consists of a full node (hsd) and a light client (hnsd). The full node allows users to register, update, and transfer names, resolve names, and make blockchain payments. The light client (SPV node) allows users to resolve names without the computing resource requirements of running a full node.

This guide includes instructions for installing hsd and hnsd.

Note: the instructions are specifically for Debian/Ubuntu. Be sure to use the proper package manager for your OS. The BSDs and Solaris have not been tested yet, but should work in theory.

hsd Installation Instructions

Install dependencies

$ sudo apt install nodejs git

Download and install hsd

$ git clone git@github.com:handshake-org/hsd.git
$ cd hsd
$ npm install --production

Start (on testnet)

$ ./bin/hsd --daemon --no-auth

hnsd Installation Instructions

Install dependencies

$ sudo apt install automake autoconf libtool unbound libunbound-dev

Note: unbound-devel in yum

Download and compile hnsd

git clone git@github.com:handshake-org/hnsd.git
cd hnsd
./autogen.sh && ./configure --with-network && make

Start hnsd

sudo setcap 'cap_net_bind_service=+ep' /path/to/hnsd
./hnsd --pool-size=1 --rs-host=

Configure nameserver settings

  1. resolv.conf
$ echo 'nameserver' | sudo tee /etc/resolv.conf > /dev/null
  1. Edit resolvconf.conf to match:

See a mistake? Open a pull request.