Getting started

Last change on 2020-11-26 • Created on 2020-06-04

Important: To manage domains in our administration interface Robot, you must first order the Domain Registration Robot

Overview

This tutorial describes the steps involved in registering a new domain via the Hetzner Domain Robot.

Basically this involves the following steps:

  • Create a contact handle (menu item Handles)
  • Create or configure nameservers (menu item DNS entries)
  • Register Domains (menu item Domains)

Create contact

Generate contact handles

Firstly, handles for the holder, the administrative contact (Admin-C) and the technical contact (Tech-C) as well as the zone administrator (Zone-C) should be created, if these do not yet exist.

Handles which already exist and are being used in different domains can and should be reused. Please note that handles can only be used for the same top level domain (ie. .de handles will not work with .com domains). Moreover, all four functions (Holder, Admin-C, Tech-C and Zone-C) can be assumed by one person. In this case only one single handle needs to be created.

Please note that for .de domains the Admin/Tech/Zone -C does not any longer contain on the domain data. Instead, you have to create a separate handle with the type "request" which you can use for the regarding request roles.

Pay attention to the characters

The reference box to the right under menu item Handles -> New Handle shows the approved characters for each field.

Wait for "success" email

After generating the handle, the Robot sends two emails:

A confirmation email gets sent immediately and then a success or error notification later (this can take a few minutes).

Create a DNS entry

Case A: Using Hetzner nameservers

In order to be able to use the Robot nameservers, a corresponding DNS entry needs to be created for the domain via the Robot (DNS entries -> Add new zone).

Further information may be found in the article on creating DNS Entries in the DNS console.

Case B: Own nameservers

Using your own nameservers has the advantage of being able to amend entries in the zones on a more flexible basis, plus it is free of charge. However, a basic knowledge on how to administer your own nameserver is necessary.

Important: Most registrars require you to have at least two nameservers and in some cases their IP addresses need to be in different subnets. If you only have one dedicated server, the "Secondary" option in the DNS console is offered by Hetzner.

A useful configuration example of a zone file can be found in the Hetzner Wiki article on how to set up a DNS zone file.

The nameserver configuration can be best tested by using tools such as dig or nslookup in Windows. If a mistake has been made when configuring the zone, the Registry check will fail.

Do I need to register my nameserver?

If you want to use your own nameservers for .com, .net, .org, .info, .biz, .eu domains, you need to first register the nameservers via the Robot (menu item Domains -> Registered nameservers).

Domain Registration

Domain Information

Select appropriate handles for the top level domains (eg. .de handles do not work with .com domains)

Add nameservers

If primary and/or secondary Hetzner nameservers are used it is not necessary to change the corresponding server entries.

With the use of own nameservers the hostnames (not just the IP addresses) of the servers concerned are added.

Glue Records (only .de/.at domains)

Should the hostnames of the nameservers be located within the new domain you need to add the glue records in the input fields for the nameservers.

Example: The nameservers for the domain yourserver.de should be entered as ns1.yourserver.de and ns2.yourserver.de (ip addresses 213.133.101.1 and 213.133.105.1).

In the input fields for the nameservers you need to add Hostname of the nameserver + space + IP Address for the nameserver.

ns1.yourserver.de 213.133.101.1
ns2.yourserver.de 213.133.105.1

If you wish to set an ipv6 as well as an ipv4 glue record, you need to add the following:

ns1.yourserver.de 213.133.101.1 12ab:23cd:34ef:0:0:0:0:1
ns2.yourserver.de 213.133.105.1 12ab:23cd:34ea:0:0:0:0:1

Wait for "success" email

Once more the Robot will send two emails. The first confirmation email immediately after registration, and later (this may take a few minutes) the success or error notification.

If the registration fails (red light) please correct the entries in the Robot and/or zone file and repeat the whole process.

Wait for registry

New domain information is only updated once or twice a day by the registrars, up to which point the domain will not be accessible. However, the domain should be reachable between 12 and 24 hours after the "success" email at the very latest.

Testing

Online tools such as www.dnsstuff.com can for example be used to test the new domain.

Table of Contents