Feature: Dynamic DNS

From Yombo
Jump to: navigation, search

Summary

Yombo gateway features a seamless automatic dynamic DNS that allows remote access to the automation system when away from home. The domain name is also used by 3rd party applications and devices, such as smart speakers (Eg, Alexa, Google Home) to directly send commands to devices.

Dynamic domain name allows you to setup a vanity domain name such as example.yombo.me.

How it works

During installation of the software, a domain name is selected when running the setup wizard. When the gateway starts, and periodically during run time, the gateway looks up both its internal IP address on the local network as well as its external facing ip address. This information is sent to the Yombo cloud. Whenever software asks for the IP address of the domain for the automation system, Yombo's DNS servers will respond to the request.

Yombo has registered several top level domains such as 'yombo.me', 'imhome.link', and 'homelink.one'. When setting up a domain for the gateway, a sub-domain is selected and prepended to the top level domain.

For example, the gateway is configured with the domain name of 'example.imhome.link'. Yombo's DNS servers will match up the requested domain name with the correct IP addresses.

Accessing the web interface

When accessing the web interface, simply type in the domain name into a web browser. The Yombo gateway connector will determine if the gateway is on the same network as your web browser or if you are accessing it externally, such as when traveling or outside the local network. The Yombo gateway connector will redirect the browser to the best final location where the gateway can be reached. The final address will take into account the port number assigned to the web interface as well.

Additional Domains

When creating the domain name, the following sub-domains are also created. Using the example domain name of 'example.imhome.link' the following additional domains are created:

  • internal.example.imhome.link - References the internal IP address of the gateway.
  • i.example.imhome.link - References the internal IP address of the gateway.
  • external.example.imhome.link - References the external facing IP address of the gateway.
  • e.example.imhome.link - References the external IP address of the gateway.
  • localhost.imhome.link - Returns 127.0.0.1.

These domains can also be referenced in scripts or other applications to find the IP address of the gateway.

Changing Domain Names

 

Domain name settings can be updated within the Web interface - DNS Settings page. Note: Domain names can only be changed once every 30 days.

For assistance with changing the domain name, see: KB - Setting dynamic DNS

Other Notes

A domain name must be assigned to the gateway before any HTTPS certificates can be issued.

What else is it used for?

The dynamic DNS system is also used if using the gateway clustering feature. This allows gateways to be connected between networks or within the same network.

Is this required?

No, but highly recommended. Without this, HTTPS (TLS) cannot be properly setup. Also, encrypted communications between gateways may not be possible.

How long is the DNS good for?

The domain name will persist for as long as the gateway is active. Any gateways offline for more than 90 will have its dynamic DNS name removed and made available for other users.

I have my own domain, can I use that?

You can use your own domain name to set CNAME records to the DNS name you have selected within the web interface.

At this time, to fully use your own domain, the domain name would have to be transferred to Yombo for all users to utilize.

Is there a limit?

Yes, one DNS name per installation.

This page was last edited on 27 October 2018.