Scaleway DNS

Scaleway DNS Overview

Scaleway DNS is a managed DNS service that allows you to easily configure the DNS zones of your domains. It provides support for queries via both IPv4 and IPv6 and supports all common types of DNS records.

Core Concepts

The Domain Name System (DNS) is a name management system for computing devices connected to a network, be it public (Internet) or private. It associates domain names, that are more easily memorized, with the numerical IP addresses of the computing devices.

This system defines domain namespaces, divided into:

  • Top Level Domains: .com or .net, for example.
  • Second-level domains: example.com
  • Subdomains: mysite.example.com or sub.domain.example.com.

A DNS zone file is a distinct part of the domain namespace, containing one or more subdomains, which is delegated to a person, organization or a company which is responsible for maintaining the information related to the zone. It is handled by a Name Server and contains information of all records for a given domain name.

The DNS is based on central servers, called Root-Servers which contain information about the authoritative DNS servers for each Top-Level domain. These DNS servers contain information about each Second-Level domain and their DNS delegation. Each second-level domain is defined as a separate DNS zone which can be controlled by the legal entity owning the domain name. It contains all information required to resolve the domain name and/or its sub domains as well as information related to mail servers and more.

Adding External Domains

Scaleway DNS is currently available to manage DNS zones for external domains (ones created at external registrars). To begin:

1 . Click on DNS in the left menu, under Network.

The DNS management dashboard displays:

2 . Enter the external domain name in the box and click on the search icon to verify the domain exists. Once verified, you will see the following message:

Click on Next to add your domain name and proceed to Validation.

3 . To validate your domain name, you must confirm domain ownership by adding a TXTrecord to the root zone of your domain at your current registrar.

Follow the steps as indicated:

1 . Your domain has been added. In order to complete the validation of this domain name, you need to copy the token: a new token is automatically generated each time you request the validation of a domain

2 . Configure it as TXT record in the root zone of your domain at your current registrar:

Name: _scaleway-challenge

Type: TXT

Value: <TOKEN_VALUE>

3 . You will receive an e-mail on how to complete the setup of your external domain, once the domain ownership has been validated automatically.

Note: The token’s presence will be checked regularly. If it has not been set within 48 hours, the external domain will be deleted from the service.

4 . Once you have completed all the steps, click on Manage as External Domain. The DNS management dashboard appears, displaying a list of your external domains.

The status of any ongoing DNS challenges is visible through a small circle on the left-side of the domain names. If a token included in a TXT record has not yet been validated, a circle will blink in blue until it is:

Once the record has been validated, the circle turns green and you will receive an e-mail with further instructions on how to update your domain’s DNS servers.

5 . As indicated in the e-mail, update the Name Server information at your current registrar in order to link your existing domain name with your Scaleway Domains DNS zone. The nameservers are provided in the e-mail.

You can verify if the association of your domain has been successfully completed by checking the Nameservers list in the Domain Information page.

Note: If the entire process is not completed after 14 days, the domains are deleted from the DNS and you will have to start over. E-mails reminding you to complete the process are sent in intervals of 7 and 13 days from its beginning.

Managing External Domains

Once your external domains have been created and validated, you may click on next to their name for more information.

The Domain Information page gives you a view on the status of your domains, as well as a list of all nameservers associated with it. At the bottom of the page you also have the option of deleting your domain from Scaleway DNS.

Configuring DNS Zones

On the Domain Information page you can also access the Zones tab, which provides a list of Zones configured within the selected domain.

A DNS zone is a distinct part of the domain namespace and allows granular control of DNS components. It contains configuration information such as A or MX records. Each Zone Name created translates into a Domain Name. For example the zone myzone in the domain example.com becomes myzone.example.com. This works also on multiple levels, meaning that the zone myzone.subdomain becomes the domain name myzone.subdomain.example.com.

The Root Zone is always available, by default. The zone is directly associated with the domain name and cannot be deleted. It will only be removed from the DNS when its associated domain name is deleted.

To add a new zone, click on the green + button and enter a name for it in the pop-up box. Conclude by clicking on Add Zone.

You can edit a zone’s name at any time by clicking on and then on Edit Name in the Zones page.

A pop-up box displays. Enter the new name and click on Edit Name to confirm.

To delete a zone, click on Delete in the dropdown menu. A pop-up appears displaying the following message:

Be careful! This will permanently delete your zone and all its associated data will be lost. This action is irreversible.

Read it carefully and if you wish to continue, type DELETE in the box. Then, click on Delete this zone to confirm.

Managing Records

Information in DNS zones is categorized and organized through a list of DNS record types, called Resource Records (RRs).

Each of these records has a type, an expiration time (Time to Live - TTL), a name, and type-specific data for certain types of records.

The most common records are:

  • A record: Address record, it is mostly used to map domain names to the IPv4 address of a specific server
  • AAAA record: IPv6 Address record, it returns an IPv6 address and is mostly used to map domain names to the IPv6 address of a specific server.
  • CNAME record: Canonical name record, an alias of one name to another. The DNS lookup will continue by looking up the new name.
  • MX record: Mail exchange record, it maps a domain name to a list of one or several mail servers for that domain.
  • TXT record: Text record, it is often used to carry machine-readable data such as information for automated domain validation.

To edit or add a new record to a zone, access the Zones page and click directly on the zone name or on and then on Records.

A list of records displays. To edit them, fill in the boxes with the requested information and click on the green check icon to save. If you wish to cancel changes before saving, click on the red no icon.

If you wish to delete a record, click on the trashcan icon.

Deleting a Domain

You can delete a domain from Scaleway DNS either by clicking on next to the selected domain name in your DNS management dashboard and then on Delete or on Delete Domain on the Domain Information page.

In both cases, once you click to delete, a pop-up appears:

Warning: This will permanently delete your external domain and its related zones from Scaleway DNS. This action is irreversible and your domain name may become unresolvable.

If you have read the warning and wish to continue, type DELETE in the box and click on Delete this external domain to confirm.

Discover the Cloud That Makes Sense