Dynamic DNS

Dynamic DNS allows you to direct your domain or a subdomain to a resource that is behind a gateway that has a dynamically assigned IP address.

To use dynamic DNS with Google Domains you set up a Dynamic DNS synthetic record. This synthetic record:

• Sets up an A or AAAA record for your domain or subdomain that lets the Google name servers know to expect a dynamic IP.
• Generates a username and password your host or server will use to communicate the new IP address to the Google name servers.

Once you set up the Dynamic DNS synthetic record, you must set up a client program on your host or server (the resource behind the gateway) or on the gateway itself that detects IP address changes and uses the generated username and password and communicate the new address to the Google name servers.

Note: Dynamic DNS works with both IPv4 and IPv6 addresses. 

Setting up a Dynamic DNS synthetic record

1. Sign in to Google Domains.
2. Select the name of your domain.
3. Open the menu .
4. Click DNS.
5. Scroll down to Synthetic Records.
6. Select Dynamic DNS from the list of synthetic record types.
7. Enter the name of the resource you plan to have assigned a Dynamic IP, either a subdomain or @ for your default domain (“root domain” or “naked domain”).
8. If you selected sub-domain, enter the name of the subdomain.
9. Click Add.
10. The Dynamic DNS record is created in your list of synthetic records. Click the expand triangle next to the record to view its values.
11. Click View Credentials to view the user name and password created for this record.
12. Note the username and password created for the synthetic record. You'll need these to configure your gateway or client software to contact the Google name servers.

You can edit or delete the record with the Edit and Delete buttons next to the record.

Setting up a client program on your gateway, host, or server

There are several popular dynamic DNS clients in use, such as DDclient and INADYN. In addition most routers have software built in to detect IP changes and communicate them with the name servers.

Note: Google Domains uses the dyndns2 protocol.

Configure your dynamic DNS client with:

• Provider (or DNS or Service): The name of your DNS Provider.
• Username: (or credential) the generated username in the Dynamic DNS record.
• Password (or credential): the generated password in the Dynamic DNS record.

After you have created the record and configured your client software, test it by entering the subdomain and domain into a web browser (or appropriate client) and seeing that it connects to the correct resource.

Examples

DDclient now has support for Google Domains.

DDclient with Google Domains Support

ddclient.conf entries: ssl=yes protocol=googledomains login=generated_username password=generated_password your_resource.your_domain.tld

General client configuration examples:

DDclient without Google Domains support	INADYN
Sample ddclient.conf entries: protocol=dyndns2 use=web server=domains.google.com ssl=yes login=generated_username password=generated_password your_resource.your_domain.tld	Add the following to your inadyn.conf system [e-mail] username generated_username password generated_password alias sub.domain.tld

 

Using the API to update your Dynamic DNS record

Dynamic DNS client software automatically updates your dynamic DNS record. You can perform updates manually with the API by making making a POST request (GET is also allowed) to the following url:
https://domains.google.com/nic/update

The API requires HTTPS. Here’s an example request:
https://username:[e-mail]/nic/update?hostname=subdomain.yourdomain.com&myip=1.2.3.4

Note: You must set a user agent in your request as well. Web browsers will generally add this for you when testing via the above url. In any case, the final HTTP request sent to our servers should look something like this:

Example HTTP query:
POST /nic/update?hostname=subdomain.yourdomain.com&myip=1.2.3.4 HTTP/1.1
Host: domains.google.com
Authorization: Basic base64-encoded-auth-string User-Agent: Chrome/41.0 [e-mail]

Request Parameters:

Parameter	Required/Optional	Description
username:password	Required	The generated username and password associated with the host that is to be updated.
hostname	Required	The hostname to be updated.
myip	Optional (Required if you have an IPv6 address)	The IP address to which the host will be set. If not supplied, we’ll use the IP of the agent that sent the request. Note: myip is required if your agent uses an IPv6 address. You can check your agent’s IP address by going to https://domains.google.com/checkip.
offline	Optional	Sets the current host to offline status. If an update request is performed on an offline host, the host is removed from the offline state. Allowed values are yes no

One of the following responses will be returned after the request is processed.

Please ensure you interpret the response correctly, or you risk having your client blocked from our system.

Response	Status	Description
good 1.2.3.4	Success	The update was successful. Followed by a space and the updated IP address. You should not attempt another update until your IP address changes.
nochg 1.2.3.4	Success	The supplied IP address is already set for this host. You should not attempt another update until your IP address changes.
nohost	Error	The hostname does not exist, or does not have Dynamic DNS enabled.
badauth	Error	The username / password combination is not valid for the specified host.
notfqdn	Error	The supplied hostname is not a valid fully-qualified domain name.
badagent	Error	Your Dynamic DNS client is making bad requests. Ensure the user agent is set in the request.
abuse	Error	Dynamic DNS access for the hostname has been blocked due to failure to interpret previous responses correctly.
911	Error	An error happened on our end. Wait 5 minutes and retry.
conflict A conflict AAAA	Error	A custom A or AAAA resource record conflicts with the update. Delete the indicated resource record within DNS settings page and try the update again.