2026.1.2
Home ▸ Integrations ▸

Namecheap FreeDNS

With the Namecheap FreeDNS 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 service.

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 use the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] in your installation, add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes.

# Example configuration.yaml entry
namecheapdns:
  domain: example.com
  password: YOUR_PASSWORD

Configuration Variables

Looking for your configuration file?
host string (Optional)

The host part or “subdomain” part you want to update.

domain string Required

Your root domain (example.com).

password string Required

The Namecheap “Dynamic DNS Password” you can find under the “Advanced DNS” tab.

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