Skip to content

Instantly share code, notes, and snippets.

Last active Jul 12, 2021
What would you like to do?

Upgrade nodejs to v12.x.x

$ sudo npm install -g n
$ sudo n lts

Install hsd

$ sudo apt install libunbound-dev
$ git clone
$ cd hsd
$ npm i

Get IP

$ ifconfig
wlan0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet  netmask  broadcast

Run hsd: note that I am using the IP obtained from ifconfig as the rs-host setting

$ sudo hsd --rs-host= --rs-port=53

BONUS: enable as service for auto-restart!

edit file with this command:

$ sudo nano /lib/systemd/system/hsd.service

these are the contents:


ExecStart=/usr/local/bin/node /home/pi/hsd/bin/hsd



$ sudo systemctl daemon-reload
$ sudo systemctl enable hsd.service
$ sudo systemctl start hsd

The service file is just a nice touch to enable auto-restart. For static IP, I followed this guide: and just set my static IP to which was the address my router DHCP gave me anyway

Then I set my iphone settings to the screenshot below under my home wifi network:

and OSX network settings:


This comment has been minimized.

Copy link

@Falci Falci commented Oct 9, 2020

Tip: add the in the router as default DNS for any device (DHCP section).


This comment has been minimized.

Copy link

@faddat faddat commented Nov 15, 2020




This comment has been minimized.

Copy link

@magicstone1412 magicstone1412 commented Jan 1, 2021

Thank you for your guide.

It's more convenient to set up a light node combine with Wireguard.

  • You don't need to set up manually static IP
  • Use your own Handshake DNS resolver anywhere
  • Turn DNS resolver faster: only ON or OFF
  • Quick DNS value modification in Wireguard setting files
  • Lighter than a full node

At this time, I can resolve Handshake name on my phone by putting the DNS IP in the Wireguard configuration file, but I am not sure why it does not work on my computer.

Edit: I can access Handshake name site on computer after reset about:config on firefox to default settings based on this guide


This comment has been minimized.

Copy link

@unclehowell unclehowell commented Mar 15, 2021

Imagine this had a localhost webapp/ gui and was embedded into a raspberry pi net-installer - my current project should give you some idea of what I'm suggesting - ?


This comment has been minimized.

Copy link
Owner Author

@pinheadmz pinheadmz commented Mar 15, 2021

@unclehowell cool! Let me know if you need any help, there's a HNS developer channel here:


This comment has been minimized.

Copy link

@unclehowell unclehowell commented Mar 15, 2021

Thanks. Will do!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment