Getting Started

Prerequisites

You need Docker, or a similar tool, running. Docker Desktop is fine for evaluation.

You need a license file. For evaluation a file containing just sprout-demo is a valid license for zones ending in example.com.

You need a zone file to serve, such as this example.

% echo sprout-demo >sprout.license
% curl -O https://sproutdns.com/example.json
% docker run \
  -v ./example.json:/config/zones.json:ro \
  -v ./sproutdns.license:/config/sproutdns.license:ro \
  -p 53:53/udp wttw/sproutdns:latest serve

This will start SproutDNS running on port 53, writing logs to stdout. You can query it to see that it's serving DNS for example.com.

% dig +short @127.0.0.1 _dmarc.my-customer.example.com txt
"v=DMARC1 p=none rua=rua+my-customer@example.com"

Last modified: 23 July 2024