Installation

Prerequisites

• Go 1.25.6 or later
• For DNS-over-TLS server: TLS certificate and key files

Install as CLI Tool

Using go install

go install github.com/go-idp/dns/cmd/dns@latest

Build from Source

# Clone the repository
git clone https://github.com/go-idp/dns.git
cd dns

# Build the binary
go build -o bin/dns ./cmd/dns

# Or install globally
go install ./cmd/dns

Verify Installation

dns --version

Docker

Docker images are available on Docker Hub.

docker pull goidp/dns:latest

Next Steps

• Quick Start - Get started with your first DNS query
• Client Usage - Learn how to use the DNS client
• Server Usage - Learn how to run a DNS server