TypeScript icon, indicating that this package has built-in type declarations

3.34.0 • Public • Published


Dappy node is a DoH and an authoritative name server, written in NodeJS. It is a core component of the dappy protocol and ecosystem.

Dappy node is currently available with three connectors for storing the zones : memory (dev), postreSQL (production) and RChain (blockchain, experimental).

dappy website

docs for domain purchase and management

dappy-tools repository

Quick start

Run a dappy-node with memory zone provider using npx

# Run a dappy-node that save zones in memory
DAPPY_NODE_ZONE_PROVIDER=memory DAPPY_NODE_CACHING=0 npx @fabcotech/dappy-node

# Resolve example.d A record
dappy-lookup example.d A --endpoint=

Build and test

# In dappy-tools root
npm i & npx lerna bootstrap

# Build the npm lib from dappy-tools/packages/dappy-node
npm i
npm run build

# Build the docker image from dappy-tools/
docker build . -f ./packages/dappy-node/Dockerfile -t dappynodelocal

# test
npm run test

Understanding dappy-node

Zone providers

Dappy-node abstracts how zones and records are persisted.

There are 3 zone providers availables:

  • memory: for demo and development purpose. It contains a built-in zone example with some records. It is the easiest way to start and experiment dappy-node.
  • postgresql: for production purposes when confidentiality is needed. Zones and records are persisted on a pg instance.
  • rchain: experimental provider that connects with a RChain (L1) deployment.

Each of these zone providers have their own jobs and routes.

Use DAPPY_NODE_ZONE_PROVIDER environment variable to define zone_provider.


Dappy-node is queryable over HTTPS. It implements DoH RFC. DNS packets are sent over HTTPS in binary format.

Under the hood, dappy-node use dns-packet to decode and encode DNS packets.

Every DoH clients can query dappy-node, it includes browsers like Chrome. Dappy provide a command line dappy-lookup that makes DoH queries. You can try it like this:

npx @fabcotech/dappy-lookup example.d A --endpoint=


We are open to, and grateful for, any contributions made by the community.

Report a bug

We use the issue tracker to keep track of bugs and improvements to dappy-node itself and the documentation. We encourage you to open issues to discuss improvements, architecture, theory, internal implementation, etc. If a topic has been discussed before, we will ask you to join the previous discussion.


dappy-node configuration

dappy-node is configurable through environments variables. To be more convenient, dappy-node try to load a .env file named dappyrc at startup.

Below, here are all environments variables read by dappy-node.

General environment variables

Keys Required Default value Description
DAPPY_NODE_ZONE_PROVIDER No rchain Zone provider used
DAPPY_NODE_DNS_PORT No dappy-node dns port, disabled if not provided
DAPPY_NODE_HTTP_PORT Yes 3001 dappy-node http port
DAPPY_NODE_HTTPS_PORT No dappy-node https port. HTTPS is disabled if not defined
DAPPY_NODE_PRIVATE_KEY_FILENAME No dappynode.key dappy-node private key. Generated if not exists
DAPPY_NODE_CERTIFICATE_FILENAME No dappynode.crt dappy-node certificate. Generated if not exists
DAPPY_NODE_CACHING Yes 60 record ttl cache. Disabled if set to 0
DAPPY_NODE_SENTRY_URL No false Send logs to sentry
DAPPY_NETWORK_ID Yes unknown, gamma, beta or d
DAPPY_NETWORK_MASTER_PUBLIC_KEY No 04ea33c... Public key to check messages for zone creation (dappy network master)
DAPPY_NETWORK_FILE No File path of a dappy network .json file
DAPPY_LOG_PATH Yes ./logs path to log warning and errors

if DAPPY_NETWORK_ID is unknown, the program will try to load a dappy network from the file ./dappyNetwork.js.

Environment variables read when postgresql is used as zone provider

Keys Required Default value (dev) Description
DAPPY_PG_CONNECTION_STRING No postgresql://postgres:postgres@localhost:5432/dappy postgresql connection string
DAPPY_NETWORK_MEMBER_TO_DOWNLOAD_ZONES_FROM No `` the network member hostname you want to download zones from
DOWNLOAD_ZONES_IF_EMPTY No false do you want to download the zones if there are zero zones in pg (setup)
DAPPY_NETWORK_ID No local ID of the dappy network you want to connect to
DAPPY_NETWORK_MASTER_PUBLIC_KEY No 04ea33c4... The public key of the entity able to send new zones

API Reference

Please read API Reference for more details.


Kubernetes guide


When deploying using docker, we assume you have setup a secure postgreSQL database already (on your server or a cloud provider). And know the DAPPY_PG_CONNECTION_STRING (in the format postgresql://postgres:postgres@db1234.cloudprovider.com:5432/dappy) for allowing dappy-node to write/ready in the database.

Note : the host address from within the container may vary depending on your OS, on linux it's probably, on macOS host.docker.internal.

.pgdata folder is shared with container, it will be useful only if you're running a pg instance locally.

docker compose up

dappy-nod should be exposed on port 3001, you can run curl localhost:3001/hashes to make sure it's up, and responds with hashes of the zones.

Now you must to link your local port 3001 to the public port 443 or else of your public IP address. (nginx or Apache). You'll need to generate a certificate (see Kubernetes guide) and configure your nginx to use this self signed certificate.

Local postgreSQL and adminer

Want to start a local postgreSQL (localhost:5432) + adminer (localhost:8082) ? (we do not recommend for production)

docker compose --file docker-compose-pg-adminer.yml  up




Package Sidebar


npm i @fabcotech/dappy-node

Weekly Downloads






Unpacked Size

699 kB

Total Files


Last publish


  • popul
  • fabcotechraf