Running a node with dhtnode

dhtnode is a command-line utility included with OpenDHT to run, control and monitor an OpenDHT node.

Running dhtnode

dhtnode [-p local_port] [-b bootstrap_host:port] [-i] [-v]

• -b allows to specify a bootstrap node address.
• -p allows to specify the local UDP port to bind (optional). If not set, will use any available port. Note that the default OpenDHT port (to ideally use for public nodes) is 4222.
• -i will generate a DHT "identity" with the node (RSA key pair, and certificate published on the DHT). Required to perform cryptographic operations (encrypt/sign values).
• -v will enable debug logs for OpenDHT to standard output.

for instance:

dhtnode -b bootstrap.ring.cx:4222 will run a node and use bootstrap.ring.cx port 4222 as a bootstrap node.

Commands

help

Show a command list with usage.

b {node_hostname:port}

Bootstrap/ping a DHT node. Similar to providing -b host:port as a command line parameter.

g {key}

Get values for {key} (the key is a 40 hexadecimal characters string).

l {key}

Listen for value changes at {key} (the key is a 40 hexadecimal characters string).

p {key} {string_value}

Put the text value {string_value} at {key}.