doggo

doggo [query options] [arguments...]Arguments may be given free-form: doggo recognises a hostname, a record type, a class, and an @resolver in any order.

doggo is a command-line DNS client written in Go, positioned as a friendlier `dig`. It prints a tabular, colourised answer by default and can emit JSON for scripting.Beyond plain UDP and TCP it speaks the modern encrypted transports: DNS over HTTPS, DNS over TLS, DNS over QUIC, and DNSCrypt. The resolver is chosen by prefixing it with a URL scheme, which keeps one flagless syntax for every protocol.doggo reads `/etc/resolv.conf` for the system nameserver, ndots value, and search list, so bare hostnames resolve the way they would for any other program. Header flags, EDNS options, and DNSSEC can all be toggled from the command line, and --gp-from runs the same query from Globalping probes around the world to compare answers between regions.

-q, --query=HOSTNAME

Hostname to query the DNS records for.

Type of the DNS record (A, AAAA, MX, NS, TXT, ...).

Address of a specific nameserver to send queries to.

Network class of the DNS record (IN, CH, HS).

Reverse lookup of an IPv4 or IPv6 address; sets type PTR and class IN.

Query all supported record types (A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, TXT, CAA).

Find the domain's zone via its SOA and query the delegated authoritative nameservers.

How to pick among nameservers: all, random, first, or internal.

ndots value; taken from `/etc/resolv.conf` for the system nameserver, otherwise 1.

Use the search list from `resolv.conf` (default true; --search=false disables it).

Resolver timeout, e.g. `5s`, `400ms`, `1m`.

Restrict queries to IPv4 or IPv6 only.

Hostname used for certificate verification when the DoT nameserver is given as an IP.

Skip TLS hostname verification for DoT lookups.

Set the Authoritative Answer, Authenticated Data, Checking Disabled, Recursion Desired (on by default), DNSSEC OK, and Z header flags.

EDNS options: request the Name Server Identifier, a DNS Cookie, EDNS padding, or Extended DNS Errors.

Send an EDNS Client Subnet such as `192.0.2.0/24`, for geo-aware responses.

EDNS UDP buffer size (512-65535); setting it enables EDNS. Defaults to 1232 when EDNS is on.

Format the output as JSON.

Short output: response section only.

Colourised output (default true; --color=false disables it).

Show how long the server took to respond.

Enable debug logging.

Run the query from Globalping probes in a given location, limiting the number of probes.

Print the shell completion script for the given shell.

The resolver is selected with a URL-style scheme after @. Plain UDP is used when no scheme is given.@udp://1.1.1.1

UDP query to port 53 (the default).

TCP query to port 53.

DNS over TLS (DoT) to port 853.

DNS over HTTPS (DoH).

DNS over QUIC (DoQ).

DNSCrypt or DoH via a DNS stamp.

Encrypted transports only work against resolvers that support them. --short hides the question, authority, and additional sections, which is convenient but drops information you often need when debugging. Colour is on by default, so pass --color=false when parsing output with anything other than --json. Globalping queries are executed by a third-party service rather than from your own machine.

doggo was created by Karan Sharma and first released in 2020. It was inspired by dog, the Rust DNS client, but written in Go so that it ships as a single static binary. It has since grown well past its inspiration with DNSCrypt, DNS over QUIC, Globalping integration, and a web frontend, and unlike dog it remains actively maintained.

dig(1), dog(1), drill(1), nslookup(1), host(1)

Source code · Homepage · Documentation