2026.2.1
Home ▸ Integrations ▸

Namecheap DynamicDNS

With the Namecheap DynamicDNS integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] you can automatically update your dynamic DNS entry hosted by Namecheap’s FreeDNS or PremiumDNS services.

Prerequisites

Before setting up the integration, you need the following elements:

  • Have a Namecheap account.
  • The host ( @ to update the root domain) and the domain you want to update, as well as the Dynamic DNS password for the domain. You can find the Dynamic DNS password in your Namecheap account under Domain List > Manage > Advanced DNS > Dynamic DNS.

About Namecheap

Namecheap is a domain registrar and web hosting provider that offers free and paid DNS services, including a dynamic DNS update service, for domains registered both with Namecheap and with other registrars.

Configuration

To add the Namecheap DynamicDNS 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 Namecheap DynamicDNS.

  • Follow the instructions on screen to complete the setup.

Configuration parameters

host

The host to update (‘home’ for home.example.com). Use ‘@’ to update the root domain

domain

The domain to update (‘example.com’)

password

Dynamic DNS password for the domain

See Namecheap’s How do I set up a Host for Dynamic DNS? guide for further instructions.

Data updates

This integration syncs your public IP with your (sub)domain’s DNS record every 5 minutes.

Known limitations

  • Namecheap only supports updating IPv4 addresses.
  • The integration updates your (sub)domain’s DNS record periodically rather than continuously monitoring your public IP.

Troubleshooting

The Namecheap DynamicDNS integration relies on an active internet connection to update the DNS record of your (sub)domain. If you encounter issues, verify that your network connection is stable and the Namecheap DynamicDNS service is reachable. Additionally, the Namecheap DynamicDNS service itself may experience downtime, whether unexpected or due to scheduled maintenance.

In any case, before reporting an issue, please enable debug logging, restart the integration, and as soon as the issue reoccurs, stop the debug logging again (download of debug log file will start automatically).

Removing the integration

This integration can be removed by following these steps:

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.

Related topics