Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(fix): add steps for first time external domain registration #4698

Merged
merged 1 commit into from
Mar 26, 2025
Merged

docs(fix): add steps for first time external domain registration #4698

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
85 changes: 60 additions & 25 deletions pages/domains-and-dns/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ content:
paragraph: Discover how to effectively manage your domains and DNS zones using Scaleway's intuitive platform. From registering both internal and external domains to configuring DNS zones and adding DNS records, streamline your network management tasks.
tags: domains dns internal-domain external-domain
dates:
validation: 2024-11-27
validation: 2025-03-25
posted: 2021-05-26
categories:
- network
Expand Down Expand Up @@ -40,33 +40,68 @@ categories:

## How to register an external domain

1. Click **Domains and DNS** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. The Domains and DNS screen displays.
2. Click the **External domains** tab, then click **+ Manage new domain**.
3. Enter the external domain name in the search bar and hit `Enter` to check if the domain exists.
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.
6. Copy the token displayed and [create](/domains-and-dns/how-to/manage-dns-records/#how-to-add-dns-records) a `TXT` record with the name `_scaleway-challenge` within your current DNS zone as instructed.
<Message type="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.
The domain registration process differs depending on whether or not you already have domains with Scaleway Domains and DNS.

<Tabs id="install">
<TabsTab label="How to register an external domain for the first time">
1. Click **Domains and DNS** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. The Domains and DNS screen displays.
2. Click **+ Search domain name**.
3. Enter the domain name you wish to register in the search bar and hit `Enter` to verify that the domain is available. A list of domain names displays with their availability status.
4. Click **Manage as external** next to the external domain you want to register.
5. Check the estimated cost and click **Manage as external**.
<Message type="important">
You must complete the steps displayed in the **Setup process** to register your domain.
</Message>
6. Copy the token displayed and [create](/domains-and-dns/how-to/manage-dns-records/#how-to-add-dns-records) a `TXT` record with the name `_scaleway-challenge` within your current DNS zone as instructed.
<Message type="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.
</Message>
7. Click **Back to my external domains** once you have set up the record in your current DNS zone. Your external domain displays.
The status of any ongoing DNS operations is visible through a blue dot on the left side of the domain.
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.
<Message type="note">
Scaleway's DNS servers are:
* ns0.dom.scw.cloud
* ns1.dom.scw.cloud
</Message>

You can verify whether the association of your domain has been completed by checking the **Name servers** section, in the **Domain information** page.

<Message type="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.
</Message>
</TabsTab>
<TabsTab label="How to register additional external domains">
1. Click **Domains and DNS** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. The Domains and DNS screen displays.
2. Click the **External domains** tab, then click **+ Manage new domain**.
3. Enter the external domain name in the search bar and hit `Enter` to check if the domain exists.
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.
6. Copy the token displayed and [create](/domains-and-dns/how-to/manage-dns-records/#how-to-add-dns-records) a `TXT` record with the name `_scaleway-challenge` within your current DNS zone as instructed.
<Message type="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.
</Message>
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 operations is visible through a blue dot on the left side of the domain.
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.
<Message type="note">
Scaleway's DNS servers are:
* ns0.dom.scw.cloud
* ns1.dom.scw.cloud
</Message>
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 operations is visible through a blue dot on the left side of the domain.
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.
<Message type="note">
Scaleway's DNS servers are:
* ns0.dom.scw.cloud
* ns1.dom.scw.cloud
</Message>

You can verify whether the association of your domain has been completed by checking the **Name servers** section, in the **Domain information** page.

<Message type="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.
</Message>
You can verify whether the association of your domain has been completed by checking the **Name servers** section, in the **Domain information** page.

<Message type="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.
</Message>
</TabsTab>
</Tabs>

## How to add a new DNS zone

Expand Down
Loading