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

layout	title	description	date	sidebar	comments	sharing	footer	ha_category	ha_release
page	freedns.afraid.org	Keep your DNS record up to date with FreeDNS.	2018-03-27 21:30	true	false	true	true	Network	0.67

With the freedns component you can keep your FreeDNS record up to date.

{% linkable_title Setup %}

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 candiates 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.

{% linkable_title Configuration %}

To use the component in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
freedns:
  access_token: YOUR_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 update_interval: description: How often to call the update service. required: false type: time period default: 10 minutes {% endconfiguration %}