Home Assistant

FreeDNS

With the freedns integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] 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 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
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 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:

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

Configuration Variables

Looking for your configuration file?
access_token string (Optional)

Your access token. This is exclusive to url.

url string (Optional)

The full update URL. This is exclusive to access_token.

scan_interval time (Optional, default: 10 minutes)

How often to call the update service.