HSD

hsd

Handshake daemon and full node

Runs as hsd, hsd-cli, hsw-cli|macOS, Linux|github.com

Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 8 fields

Start the Handshake node with DNS ports and inbound connections configured. API keys, mining and wallet options are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui hsd

Start hsdExample values, fixed in this page — nothing here reaches a terminal

Basic

Authoritative DNS port*

integer

Recursive DNS host

string

Recursive DNS port

integer

TasksEach one presets the form for one job

Custom DNS ports

ns_portrs_hostrs_port

Accept inbound peers

listenmax_inboundpublic_host

ParametersOnly these flags are editable in the form

Authoritative DNS port

Default 5349.
integer

--ns-port

Recursive DNS host

0.0.0.0 makes the resolver public.
string

--rs-host

Recursive DNS port

Default 5350.
integer

--rs-port

Accept inbound connections

boolean

--listen

Max inbound peers

integer

--max-inbound

Public host

Advertise this address to peers.
string

--public-host

HTTP host

string

--http-host

Coinbase address

string

--coinbase-address

SourcesEvery flag above is checked against these

readme

$ hsd --ns-port 5300 $ hsd --rs-host 0.0.0.0 --rs-port 53 # Warning: public! To accept inbound connections, add the `--listen` flag. $ hsd --listen --max-inbound 50 $ hsd --listen --public-host [my-public-ip-address] --max-inbound 50 $ hsd --http-host '::' --api-key 'hunter2' --coinbase-address 'ts1qsu62stru80svj5xk6mescy65v0lhg8xxtweqsr'

manual2026-10-27

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed hsd against its version. A form that does not match your version is not offered.