Home ▸ Integrations ▸

NextDNS

NextDNS is a DNS service that protects from all kinds of security threats, blocks ADS and trackers on websites and in apps, and provides a safe and supervised Internet for kids — on all devices and on all networks. The NextDNS integration allows you to monitor NextDNS statistics and control its configuration.

Prerequisites

To obtain API key go to the NextDNS site >> Account section.

Configuration

To add the NextDNS service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

Browse to your Home Assistant instance.
Go to Settings > Devices & Services.
In the bottom right corner, select the Add Integration button.
From the list, select NextDNS.
Follow the instructions on screen to complete the setup.

API Key

The API key for your NextDNS account.

Profile

The NextDNS configuration profile you want to integrate.

Removing the integration

This integration follows standard integration removal, no extra steps are required.

To remove an integration instance from Home Assistant

Go to Settings > Devices & services and select the integration card.
From the list of devices, select the integration instance you want to remove.
Next to the entry, select the three dots menu. Then, select Delete.

Supported functionality

The NextDNS integration provides the following entities.

Binary sensors

Device connection status
- Description: Indicates whether the Home Assistant server is using NextDNS for DNS queries
Device profile connection status
- Description: Indicates whether the Home Assistant server uses the configured NextDNS profile for DNS queries

Buttons

Clear logs
- Description: Triggers clearing DNS query logs on NextDNS servers

Sensors

DNS queries
- Description: Shows the total number of DNS queries
DNS queries blocked
- Description: Shows the number of blocked DNS queries
DNS queries blocked ratio
- Description: Shows the percentage of blocked DNS queries
DNS-over-HTTP/3 queries
- Description: Shows the number of DNS queries via DNS-over-HTTP/3
- Remarks: This entity is disabled by default
DNS-over-HTTP/3 queries ratio
- Description: Shows the percentage of DNS queries via DNS-over-HTTP/3
- Remarks: This entity is disabled by default
DNS-over-HTTPS queries
- Description: Shows the number of DNS queries via DNS-over-HTTPS
- Remarks: This entity is disabled by default
DNS-over-HTTPS queries ratio
- Description: Shows the percentage of DNS queries via DNS-over-HTTPS
- Remarks: This entity is disabled by default
DNS-over-QUIC queries
- Description: Shows the number of DNS queries via DNS-over-QUIC
- Remarks: This entity is disabled by default
DNS-over-QUIC queries ratio
- Description: Shows the percentage of DNS queries via DNS-over-QUIC
DNS-over-TLS queries
- Description: Shows the number of DNS queries via DNS-over-TLS
- Remarks: This entity is disabled by default
DNS-over-TLS queries ratio
- Description: Shows the percentage of DNS queries via DNS-over-TLS
- Remarks: This entity is disabled by default
TCP queries
- Description: Shows the number of DNS queries via TCP
- Remarks: This entity is disabled by default
TCP queries ratio
- Description: Shows the percentage of DNS queries via TCP
- Remarks: This entity is disabled by default
UDP queries
- Description: Shows the number of DNS queries via UDP
- Remarks: This entity is disabled by default
UDP queries ratio
- Description: Shows the percentage of DNS queries via UDP
- Remarks: This entity is disabled by default
Encrypted queries
- Description: Shows the number of encrypted DNS queries
- Remarks: This entity is disabled by default
Encrypted queries ratio
- Description: Shows the percentage of encrypted DNS queries
- Remarks: This entity is disabled by default
Unencrypted queries
- Description: Shows the number of unencrypted DNS queries
- Remarks: This entity is disabled by default
IPv4 queries
- Description: Shows the number of DNS queries via IPv4
- Remarks: This entity is disabled by default
IPv6 queries
- Description: Shows the number of DNS queries via IPv6
- Remarks: This entity is disabled by default
IPv6 queries ratio
- Description: Shows the percentage of DNS queries via IPv6
- Remarks: This entity is disabled by default
DNSSEC validated queries
- Description: Shows the number of DNS queries validated by DNSSEC
- Remarks: This entity is disabled by default
DNSSEC validated queries ratio
- Description: Shows the percentage of DNS queries validated by DNSSEC
- Remarks: This entity is disabled by default
DNSSEC not validated queries
- Description: Shows the number of DNS queries not validated by DNSSEC
- Remarks: This entity is disabled by default
DNS queries relayed
- Description: Shows the number of relayed DNS queries

Switches

AI-Driven threat detection
- Description: Controls AI-driven threat detection
Allow affiliate & tracking links
- Description: Controls affiliate and tracking links
Anonymized EDNS client subnet
- Description: Controls anonymized EDNS client subnet
Bypass age verification
- Description: Controls bypass of age verification pages
CNAME flattening
- Description: Controls CNAME flattening
Cryptojacking protection
- Description: Controls cryptojacking protection
Domain generation algorithms protection
- Description: Controls protection against domain generation algorithms
DNS rebinding protection
- Description: Controls DNS rebinding protection
Google safe browsing
- Description: Controls Google Safe Browsing protection
IDN homograph attacks protection
- Description: Controls protection against IDN homograph attacks
Logs
- Description: Controls log collection
Force SafeSearch
- Description: Controls SafeSearch enforcement
Typosquatting protection
- Description: Controls protection against typosquatting domains
Web3
- Description: Controls access to Web3 and crypto domains
Force YouTube restricted mode
- Description: Controls YouTube Restricted Mode enforcement
Block newly registered domains
- Description: Controls blocking of newly registered domains
Block bypass methods
- Description: Controls blocking of filter bypass methods
Block child sexual abuse material
- Description: Controls blocking of child sexual abuse material
Block dynamic DNS hostnames
- Description: Controls blocking of dynamic DNS hostnames
Block disguised third-party trackers
- Description: Controls blocking of disguised third-party trackers
Block page
- Description: Controls the display of the blocking page
Block online gaming
- Description: Controls blocking of online gaming
Block parked domains
- Description: Controls blocking of parked domains
Block piracy
- Description: Controls blocking of piracy websites
- Remarks: This entity is disabled by default
Block porn
- Description: Controls blocking of pornographic content
- Remarks: This entity is disabled by default
Block social networks
- Description: Controls blocking of social networks
- Remarks: This entity is disabled by default
Block video streaming
- Description: Controls blocking of video streaming websites
- Remarks: This entity is disabled by default
Block dating
- Description: Controls blocking of dating websites
- Remarks: This entity is disabled by default
Block gambling
- Description: Controls blocking of gambling websites
- Remarks: This entity is disabled by default
Block 9GAG
- Description: Controls 9GAG access
- Remarks: This entity is disabled by default
Block Amazon
- Description: Controls Amazon access
- Remarks: This entity is disabled by default
Block BeReal
- Description: Controls BeReal access
- Remarks: This entity is disabled by default
Block Blizzard
- Description: Controls Blizzard access
- Remarks: This entity is disabled by default
Block ChatGPT
- Description: Controls ChatGPT access
- Remarks: This entity is disabled by default
Block Dailymotion
- Description: Controls Dailymotion access
- Remarks: This entity is disabled by default
Block Discord
- Description: Controls Discord access
- Remarks: This entity is disabled by default
Block Disney Plus
- Description: Controls Disney Plus access
- Remarks: This entity is disabled by default
Block eBay
- Description: Controls eBay access
- Remarks: This entity is disabled by default
Block Facebook
- Description: Controls Facebook access
- Remarks: This entity is disabled by default
Block Fortnite
- Description: Controls Fortnite access
- Remarks: This entity is disabled by default
Block Google Chat
- Description: Controls Google Chat access
- Remarks: This entity is disabled by default
Block HBO Max
- Description: Controls HBO Max access
- Remarks: This entity is disabled by default
Block Hulu
- Description: Controls Hulu access
- Remarks: This entity is disabled by default
Block Imgur
- Description: Controls Imgur access
- Remarks: This entity is disabled by default
Block Instagram
- Description: Controls Instagram access
- Remarks: This entity is disabled by default
Block League of Legends
- Description: Controls League of Legends access
- Remarks: This entity is disabled by default
Block Mastodon
- Description: Controls Mastodon access
- Remarks: This entity is disabled by default
Block Messenger
- Description: Controls Facebook Messenger access
- Remarks: This entity is disabled by default
Block Minecraft
- Description: Controls Minecraft access
- Remarks: This entity is disabled by default
Block Netflix
- Description: Controls Netflix access
- Remarks: This entity is disabled by default
Block Pinterest
- Description: Controls Pinterest access
- Remarks: This entity is disabled by default
Block PlayStation Network
- Description: Controls PlayStation Network access
- Remarks: This entity is disabled by default
Block Prime Video
- Description: Controls Prime Video access
- Remarks: This entity is disabled by default
Block Reddit
- Description: Controls Reddit access
- Remarks: This entity is disabled by default
Block Roblox
- Description: Controls Roblox access
- Remarks: This entity is disabled by default
Block Signal
- Description: Controls Signal access
- Remarks: This entity is disabled by default
Block Skype
- Description: Controls Skype access
- Remarks: This entity is disabled by default
Block Snapchat
- Description: Controls Snapchat access
- Remarks: This entity is disabled by default
Block Spotify
- Description: Controls Spotify access
- Remarks: This entity is disabled by default
Block Steam
- Description: Controls Steam access
- Remarks: This entity is disabled by default
Block Telegram
- Description: Controls Telegram access
- Remarks: This entity is disabled by default
Block TikTok
- Description: Controls TikTok access
- Remarks: This entity is disabled by default
Block Tinder
- Description: Controls Tinder access
- Remarks: This entity is disabled by default
Block Tumblr
- Description: Controls Tumblr access
- Remarks: This entity is disabled by default
Block Twitch
- Description: Controls Twitch access
- Remarks: This entity is disabled by default
Block X (formerly Twitter)
- Description: Controls X (formerly Twitter) access
- Remarks: This entity is disabled by default
Block Vimeo
- Description: Controls Vimeo access
- Remarks: This entity is disabled by default
Block VK
- Description: Controls VK access
- Remarks: This entity is disabled by default
Block WhatsApp
- Description: Controls WhatsApp access
- Remarks: This entity is disabled by default
Block Xbox Network
- Description: Controls Xbox Network access
- Remarks: This entity is disabled by default
Block YouTube
- Description: Controls YouTube access
- Remarks: This entity is disabled by default
Block Zoom
- Description: Controls Zoom access
- Remarks: This entity is disabled by default

Data updates

By default, the integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] data from the NextDNS API:

Every 5 minutes for connection status data
Every 10 minutes for analytics data
Every 1 minute for settings

Possible use-cases

Monitor DNS queries from your local network or individual devices.
Track DNS query protocols to understand connection security.
Manage children’s screen time by scheduling access to social media, games, and streaming services.

Examples

Block social media for kids

These automations block social media access for the kids profile during evening hours and unblock it after school.

automation:
  - alias: Block social media for kids in the evening
    triggers:
      - trigger: time
        at: "20:00:00"
    actions:
      - action: switch.turn_off
        target:
          entity_id: switch.kids_block_social_networks
  - alias: Unblock social media for kids after school
    triggers:
      - trigger: time
        at: "16:00:00"
    actions:
      - action: switch.turn_on
        target:
          entity_id: switch.kids_block_social_networks

Known limitations

There are no known limitations.

Help us improve our documentation

Suggest an edit to this page, or provide/view feedback for this page.