Jump toUpdate content

Domains and DNS - Quickstart

Reviewed on 09 May 2023Published 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.

Security & Identity (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.
  2. Click «Plus Icon» to search a domain name.
  3. Enter the domain name you wish to register in the box.
  4. Click the search icon to verify the domain is available. A selection of available domain names displays.
  5. Check the domain names you want to register. Then click Select and configure contacts.
  6. Enter the contact details for your domain name then click Add new contact.
  7. Select your domain contact information from the drop-down list and click Validate and continue. Your order summary displays.
  8. Choose the registration period.
  9. Check the box to confirm you understand that you will be debited the price that displays.
  10. Click Register domain to confirm your order and to register the domain name.
Important:
  • Make sure to check your domain name for any spelling mistakes 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 register another domain with the correctly spelled name.
  • Internal domains are billed immediately upon registration.

How to register an external domain

  1. Click Domains and DNS in the Network section of the Scaleway console side menu. The Domains and DNS dashboard displays.
  2. Click the External domains tab, then click «Plus Icon» Manage new domain.
  3. Enter the external domain name in the box and click the search icon to check if the domain exists. The estimated cost for the domain name displays.
  4. Enter the number of million queries you need. The estimated cost for the domain name displays.
  5. Click Manage as external. The instructions to set up your external domain display. Add a TXTrecord 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.

  6. 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.

  7. Click Back to my external domains 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 a 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 email with further instructions on how to update your domain’s DNS servers.

Update the name server information at your current registrar once your 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 Name Servers 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. Emails reminding you to complete the process are sent on days 7 and 13.

How to add a new DNS zone

  1. Click Domains and DNS in the Network section of the Scaleway console side menu. The Domains and DNS dashboard displays.
  2. Click the domain for which you want to add a DNS zone. The Domain Information page displays.
  3. Click the DNS Zones tab. A list of the DNS zones you have configured within the selected domain displays.
    Note:

    The Root zone is always available, by default. This 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.

  4. Click «Plus Icon» and Add zone to create a new DNS zone. A pop-up box displays with the estimated cost for your DNS zone.
  5. Enter a name for the new zone and click Add zone.

How to delete an existing DNS zone

  1. Click Domains and DNS in the Network section of the Scaleway console side menu. The Domains and DNS dashboard displays.
  2. Click the domain for which you want to delete a DNS zone. The Domain Information page displays.
  3. Click the DNS Zones tab. A list of the DNS zones you have configured within the selected domain displays.
  4. Click «See more Icon», then click Delete.
  5. Type DELETE in the pop-up form and click Delete zone to confirm the action.

How to add DNS records

  1. Click Domains and DNS in the Network section of the Scaleway console side menu. The Domains and DNS zone dashboard displays.
  2. Click the domain you want to manage. The Domain Information page displays.
  3. Click the DNS Zones tab. A list of the DNS zones you have configured within the selected domain displays.
  4. Click the DNS zone you want to edit. A list of the zone’s records displays.
  5. Click «Plus Icon» Add record to add a new record to your DNS zone. A pop-up displays.
  6. Fill in the required information for the record.
  7. Click Add Records to confirm.

How to delete DNS records

  1. Click Domains and DNS in the Network section of the Scaleway console side menu. The Domains and DNS zone dashboard displays.
  2. Click the domain you want to manage. The Domain Information page displays.
  3. Click the DNS Zones tab. A list of the DNS zones you have configured within the selected domain displays.
  4. Click the DNS zone you want to delete. A list of records displays.
  5. Click «Delete Icon». A pop-up displays.
  6. Type DELETE to confirm.
  7. Click Delete record to remove the record from the zone.