2026.8.0
Home ▸ Integrations

DNS IP

The DNS IP integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] will expose an IP address, fetched via DNS resolution (every 2 minutes), as its value. It provides both IPv4 and IPv6 lookup as separate sensors depending on accessibility to resolvers.

  1. When you enable the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] with the default value, it will query the OpenDNS nameservers with the hostname myip.opendns.com, which will resolve to your external/public IP address.
  2. If you specify a hostname, a regular DNS lookup will be performed, providing you the IP the hostname resolves to. If your hostname resolves to multiple IP addresses, the lowest IP will be returned as the state. The first 10 IPs will be returned in ascending order in the ip_addresses attribute.

Configuration

To add the DNS IP 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:

Host

The target hostname to resolve into their IP address(es).

Resolver

Override the default DNS resolver by specifying an IPv4 (e.g., 1.1.1.1) or IPv6 address (e.g., 2606:4700:4700::1111)

Port

Override the default DNS port (53). Useful to bypass local DNS filtering or redirection.

Resolver and port may be adjusted after the integration has been setup by adjusting it’s options:

Options

To define options for DNS IP, follow these steps:

  1. In Home Assistant, go to Settings > Devices & services.

  2. If multiple instances of DNS IP are configured, choose the instance you want to configure.

  3. On the card, select the cogwheel .

    • If the card does not have a cogwheel, the integration does not support options for this service.

    Screenshot showing the cogwheel icon on an integration card in the Settings > Devices & services page

  4. Edit the options, then select Submit to save the changes.

Data fetching and limitations

Resolving the IP address(es) happens every two minutes.

If resolving the IP address(es) is not possible due to connectivity issues or other errors, it retries 3 times before going unavailable.

Troubleshooting

This service is reliant on an internet connection and that the chosen resolver(s) are available.

  • Turn on debug logging and check the logs.
  • Manually test to resolve the hostname using any command line tools or websites available.
  • Manually reload the integration.

Remove the integration

To remove an integration instance from Home Assistant

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