Basic Server Example

This example shows how to run a basic DNS server using the CLI.

Start Basic Server

# Start DNS server on port 53
dns server --port 53

Start with Custom Hosts

Create a configuration file config.yaml:

server:
  port: 53

hosts:
  "example.com": "1.2.3.4"
  "test.example.com": "1.2.3.5"

Start the server:

dns server --config config.yaml

Start with Upstream DNS

dns server --port 53 --upstream 8.8.8.8:53 --upstream 1.1.1.1:53

Testing

# Query the server using dig
dig @127.0.0.1 example.com

# Or using DNS CLI
dns client lookup example.com --server 127.0.0.1:53

Next Steps

• DoT Server Example - Learn how to run a DoT server
• Configuration File Example - Learn about configuration files