home-assistant.io/source/_integrations/freedns.markdown

title	description	ha_category	ha_iot_class	ha_release	ha_domain	ha_integration_type	ha_quality_scale
FreeDNS	Keep your DNS record up to date with FreeDNS.	Network	Cloud Push	0.67	freedns	integration	legacy

With the freedns {% term integration %} you can keep your FreeDNS record up to date.

Setup (Default API V1)

You need to determine your update URL or your access token.

1. Head over to the FreeDNS website and login to your account.
2. Select the menu "Dynamic DNS"
3. You should now see your update candidates in a table at the bottom of the page.
4. Copy the link target of the "Direct URL".
5. The access token is the part at the end of the link: https://freedns.afraid.org/dynamic/update.php?YOUR_UPDATE_TOKEN
6. Either put the token as access_token or the whole URL into the url attribute.

Configuration (API V1)

To use the {% term integration %} in your installation, add the following to your {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

# Example configuration.yaml entry
freedns:
  access_token: YOUR_TOKEN

Setup (API V2)

You need to determine your update URL or your access token.

1. Head over to the FreeDNS website and login to your account.
2. Select the menu "Dynamic DNS"
3. You should now see your update candidates in a table at the bottom of the page.
4. Head over to page Version 2, and enable the candidate.
5. The access token is the part at the end of the link: http://sync.afraid.org/u/RANDOMIZED_TOKEN/
6. Put the whole URL into the url attribute.
7. (Instead of using the randomized token URL in the Version 2 there are other options to use for URL)

Configuration (API V2)

To use the integration in your installation, add the following to your {% term "configuration.yaml" %} file:

# Example configuration.yaml entry
freedns:
  url: http://sync.afraid.org/u/RANDOMIZED_TOKEN/

{% configuration %} access_token: description: Your access token. This is exclusive to url. required: false type: string url: description: The full update URL. This is exclusive to access_token. required: false type: string scan_interval: description: How often to call the update service. required: false type: time default: 10 minutes {% endconfiguration %}