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


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:
  6. Either put the token as access_token or the whole URL into the url attribute.


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

# Example configuration.yaml entry
  access_token: YOUR_TOKEN

Configuration Variables


(string)(Optional)Your access token. This is exclusive to url.


(string)(Optional)The full update URL. This is exclusive to access_token.


(time period)(Optional)How often to call the update service.

Default value: 10 minutes