DNS

Lookup DNS info for a domain. The package powers Ghost(Pro) custom-domain checks by collecting DNS records, Cloudflare/Fastly-related metadata, and validity ratings for CNAME and SSL configuration.

Usage: pnpm --filter @tryghost/dns dns -- <blog.ghost.org> Outputs:

{
    "hostname": "blog.ghost.org",
    "domain": "ghost.org",
    "subdomain": "blog",
    "records": {
        "A": [{ "value": "104.16.127.190", "cf": true }, {}],
        "CNAME": [],
        "NS": ["sara.ns.cloudflare.com.", "woz.ns.cloudflare.com."]
    },
    "whois": "Cloudflare",
    "cloudflare": true,
    "valid": {
        "cname": "maybe",
        "ssl": "C"
    }
}

Installation

1. Make sure that gstenv is green. See Dev Environment for docs.
2. git clone this repo & cd into it as usual
3. Run pnpm install to install top-level dependencies.

Run

• Run: pnpm --filter @tryghost/dns dns -- <url>
• Aliased as pnpm --filter @tryghost/dns dev -- <url> for consistency
• Doesn't matter which you run!

You can also use it from Node:

const dns = require('@tryghost/dns');

const result = await dns('blog.ghost.org');
console.log(result.records);

Test

• pnpm --filter @tryghost/dns lint runs lint
• pnpm --filter @tryghost/dns test runs lint and tests

Publish

• Use the top-level publish instructions.

Copyright & License

Copyright (c) 2013-2026 Ghost Foundation - Released under the MIT license. Ghost and the Ghost Logo are trademarks of Ghost Foundation Ltd. Please see our trademark policy for info on acceptable usage.