Jump toUpdate content

Domains and DNS - Quickstart

Published on 26 May 2021

Scaleway Domains and DNS allows you to manage and register your internal and external domains and configure and manage their DNS zones. Register and (auto-)renew your domains easily! Domains and DNS provide support for queries via both IPv4 and IPv6.

Identity and Access Management (IAM):

If you have activated IAM, you may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets
Requirements:

How to register an internal domain

  1. Click Domains and DNS in the Network section of the Scaleway Console side menu. The Domains and DNS dashboard displays. Click Register a new domain:
  2. Enter the domain name you wish to register in the box and click the search icon to verify the domain is available. A selection of available domain names displays.
  3. Check the domain names you want to register. Then click Select and configure contacts.
  4. Enter the contact details for your domain name then click Add new contact.
  5. Select your domain contact information from the drop-down list and click Validate and continue.
  6. Choose the registration period. The total pricing for your order displays.
  7. Click Validate to confirm your order and to register the domain name.
Important:

Make sure to check your domain name for any spelling issues before you place the order.

  • You cannot change the domain name once the registration is complete and the fees will still apply. You can of course make a new registration with the correctly spelled domain name.
  • Internal domains are billed immediately upon registration.

How to manage an external domain

  1. Click DNS in the Network section of the Scaleway Console side menu. The Domains and DNS dashboard displays. Click the External Domains tab, then click Manage a new domain.
  2. Enter the external domain name in the box and click the search icon to verify the domain exists. Once verified, the following message displays:
  3. Click Next to validate your domain name. The validation instructions display.Add a TXT record to the root zone of the domain at your current registrar to validate the domain ownership.
    Note:

    TXT means text record and it is used to carry machine-readable data such as information for automated domain validation.

  4. Copy the token displayed and create a TXT record with the name _scaleway-challenge within your current DNS zone as instructed:
    Important:

    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.

  5. Click Manage as External Domain once you have set up the record in your current DNS zone. The list of your external domains displays. The status of any ongoing DNS challenges is visible through blue dot on the left-side of the domain name:

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

Update the nameserver information at your current registrar once the domain name is validated in order to link your existing domain name with your Scaleway Domains DNS zone.

Note:

Scaleway’s DNS servers are:

  • ns0.dom.scw.cloud
  • ns1.dom.scw.cloud

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

Important:

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 on days 7 and 13.

How to add a new DNS zone

  1. Click DNS in the Network section of the Scaleway Console side menu. The DNS zone dashboard displays.
  2. Click «See more Icon», then More info next to the relevant domain. The Domain Information page displays.
  3. Click + Add Zone to create a new DNS zone. A pop-up displays.
  4. Enter a name for the new zone and conclude by clicking Add Zone.

How to delete an existing DNS zone

  1. Click DNS in the Network section of the Scaleway Console side menu. The DNS zone dashboard displays.
  2. Click «See more Icon», then More info next to the relevant domain. The Domain Information page displays.
  3. Click the Zones tab. A list of the zones configured within the selected domain displays.
  4. Click «See more Icon», then Delete in the Zones page to delete a zone. A pop-up asks you to confirm the action.
  5. Type DELETE in the pop-up form and click Delete this zone.
    Important:

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

How to add DNS records

  1. Click DNS in the Network section of the Scaleway Console side menu. The DNS zone dashboard displays.
  2. Click «See more Icon», then More info next to the domain you want to manage. The Domain Information page displays.
  3. Click the Zones tab. A list of the zones configured within the selected domain displays.
  4. Click the name of the DNS zone you want to edit. A list of the zone’s records displays.
  5. Click + Add records to add a new record to your DNS zone. A pop-up displays.
  6. Fill-in the required information for the record, then confirm by clicking Add Records.

How to delete DNS records

  1. Click DNS in the Network section of the Scaleway Console side menu. The DNS zone dashboard displays.
  2. Click «See more Icon», then More info next to the domain you want to manage. The Domain Information page displays.
  3. Click the Zones tab. A list of the zones configured within the selected domain displays.
  4. Click «Delete Icon». A pop-up displays.
  5. Click Delete this record to remove the record from the zone.