MAKE IT YOURS

A small recipe.
A good beginning.

Choose how you want to resolve. Keep the essentials.
Leave with a configuration that makes sense.

YOUR STARTING POINT

A little clarity at home.

Cache answers and forward queries to upstream resolvers. A small starting point for your own network.

DNS listener port

Bound to 127.0.0.1. The default port 5353 keeps this local starter separate from your system’s DNS.

Answer cachingReuse answers within their TTL.DNSSEC validationValidate signed answers.

nothingdns.yamlLOCAL RECIPE

Your configurationyaml

# NothingDNS local starter configuration
server:
  port: 5353
  bind:
    - 127.0.0.1

cache:
  enabled: true
  size: 10000

resolution:
  recursive: false
  timeout: 5s
  qname_minimization: true

dnssec:
  enabled: true
  trust_anchor: ""

upstream:
  servers:
    - 1.1.1.1:53
    - 8.8.8.8:53

NEXT, MEET YOUR SERVER

Validate the file, start NothingDNS, then send a local query.

Try your recipebash

nothingdns -validate-config -config ./nothingdns.yaml
nothingdns -config ./nothingdns.yaml

# In another terminal
dig @127.0.0.1 -p 5353 example.com

These are local starter recipes. Add your production listeners, policies, and certificates using the full reference.Full configuration reference

Get the server Keep exploring configuration

A small recipe.A good beginning.

A little clarity at home.

A small recipe.
A good beginning.