# Exoscale Documentation — DNS

> Exoscale DNS, built with DNSimple: host your DNS zones and manage standard and extra record types via the Portal, API or CLI.

---

url: https://community.exoscale.com/product/networking/dns/

---

# DNS

- [Quick Start - DNS](https://community.exoscale.com/product/networking/dns/quick-start/index.md) - Get started quickly with a guided setup to achieve your first successful use of the service, including the required steps and configuration.
- [Overview - DNS](https://community.exoscale.com/product/networking/dns/overview/index.md) - Terminology and key features at a glance, learn the core concepts, capabilities, and options of this service before you dive deeper.
- [How-To - DNS](https://community.exoscale.com/product/networking/dns/how-to/index.md) - Step-by-step guides to configure the service and use specific features, with clear instructions for common tasks and problem solving.
- [Service Boundaries - DNS](https://community.exoscale.com/product/networking/dns/service-boundaries/index.md) - Service boundaries: quotas, limits, and the guaranteed service levels (SLA) for this product, including key constraints to plan and operate reliably.
- [Reference - DNS](https://community.exoscale.com/product/networking/dns/reference/index.md) - Reference documentation for API, CLI, and tools, browse comprehensive details, parameters, commands, and integration notes.

---

url: https://community.exoscale.com/product/networking/dns/quick-start/

---

# Quick Start - DNS



Our integrated DNS service, built in cooperation with [DNSimple](https://dnsimple.com/), provides a simple way to host your zones.

## Subscribing to the service

To subscribe to Exoscale DNS, use the Portal to select the
zone bundle which suits you best. The up-to-date list of
plans is available on our [pricing page](https://www.exoscale.com/pricing/#/dns).

Form the main Portal navigation, click on **DNS**. Select one of the zone bundles, depending on the number of DNS zones you want to manage. You can upgrade or downgrade your subscription at
any time.

![](zone-bundles.png "List of zone bundles")

## Registering domains

Exoscale has no way to register domains. You will need to buy domains from an external registrar.

After you have configured your zone (either through our API or the Portal) you will need to adjust the
NS servers for your zone with your registrar.

## DNS configuration

We have collected [a few examples](https://community.exoscale.com/product/networking/dns/how-to/config-examples/index.md) of how you might configure your DNS records.

---

url: https://community.exoscale.com/product/networking/dns/overview/

---

# Overview - DNS



The DNS service supports the following record types with standard
 and extra types. 

## Standard DNS record types

| Type | Portal | API or CLI | Description |
| ------- | --- | --- | --- |
| A | X | X | Add an "A" record that points your domain or a subdomain to an IP address.
| AAAA | X | X | Add an "AAAA" record that points your domain to an IPv6 address. These records are the same as A records except they use IPv6 addresses.
| CAA |  | X | Add a "CAA" record to your domain. Certification Authority Authorization (CAA) record is used to specify which certificate authorities (CAs) are allowed to issue certificates for a domain. Transferring CAA records to secondary name servers is not supported.
| CNAME | X | X | Add a "CNAME" record that aliases a subdomain to another host. These types of records are used when a server is reached by several names. Only use CNAME records on subdomains.
| HINFO | X | X | Add an "HINFO" record is used to describe the CPU and OS of a host.
| MX | X | X | Add a mail exchange record that points to a mail server or relay. These types of records are used to describe which servers handle incoming email.
| NAPTR | X | X | Add an "NAPTR" record to provide a means to map a resource that is not in the domain name syntax to a label that is. More information can be found in <a href="https://www.ietf.org/rfc/rfc2915.txt" target="_blank">RFC 2915</a>.
| NS | X | X | Add an "NS" record the delegates a domain to another name server. You may only delegate subdomains (for example subdomain.yourdomain.com).
| SPF | X | X | Add an "SPF" record to indicate what hosts and addresses are allowed to send mail from your domain. When creating an SPF record we will automatically create a corresponding TXT record for you as some older mail exchanges require a TXT version of the SPF record.
| SRV | X | X | Add an "SRV" record to specify the location of servers for a specific service.
| SSHFP | X | X | Edit an "SSHFP" record to share your SSH fingerprint with others.
| TXT | X | X | Add a "TXT" record. This is useful for domain records that are not covered by the standard record types. For example, Google uses this type of record for domain verification.

## Extra DNS record types

| Type | Portal | API or CLI | Description |
| ------- | --- | --- | --- |
| URL | X | X | Add an URL redirection record that points your domain to a URL. This type of record uses an HTTP redirect to redirect visitors from a domain to a web site.
| POOL | X | X | Add a "POOL" record that aliases a subdomain to another host as part of a pool of available CNAME records. This is a DNSimple custom record type.
| ALIAS | X | X | Add an "ALIAS" record. An ALIAS record is a special record that will map a domain to another domain transparently. It can be used like a CNAME but for a name with other records, like the root. When the record is resolved it will look up the A records for the aliased domain and return those as the records for the record name. Note: If you want to redirect to a URL, use a URL record instead.

---

url: https://community.exoscale.com/product/networking/dns/how-to/

---

# How-To - DNS

Step-by-step guides to configure the service and use specific features, with clear instructions for common tasks and problem solving.

- [Configure DNS Zones](https://community.exoscale.com/product/networking/dns/how-to/config-dns/index.md) - Configure DNS zones in the Exoscale Portal by adding domains, managing records, and setting registrar name servers correctly.
- [Use DNS Record Examples](https://community.exoscale.com/product/networking/dns/how-to/config-examples/index.md) - Use DNS record examples to add A, CNAME, and MX records, including root domain records that point directly to an IP address.

---

url: https://community.exoscale.com/product/networking/dns/how-to/config-dns/

---

# Configure DNS Zones

The Portal for our DNS service lets you manage all aspects of your DNS zone.

We assume for this guide that you have already chosen a zone bundle. If you have not chosen a zone bundle yet, refer to the 
[quickstart](https://community.exoscale.com/product/networking/dns/quick-start/index.md) to select one.

## Configuring a Zone via the Portal
Enter your domain name in the `Add a Domain` form and click on `Add` to add a name to the domains list.

If the status bar turns red, you cannot manage more
domains. To add more domains you need to upgrade your subscription to a 
[larger plan](https://community.exoscale.com/product/networking/dns/quick-start/index.md).

Your domain name appears in the list of managed domains. Click on the domain name to display its records.

## Configuring a Domain with a Registrar
Before going any further with the zone configuration, check the domain name
configuration with your registrar. The name servers should be set to the NS records showing on the Exoscale Portal.
If the NS record is not set, any records you set up in the Portal will not be used.

![Default NS records](dns-default.png)

---

url: https://community.exoscale.com/product/networking/dns/how-to/config-examples/

---

# Use DNS Record Examples

## Configure a machine record
* click on the `Add Record` button at the top right of the header
* Select the record type `A`
* Enter a name
* Enter the IP address of the server
* Change the TTL value if necessary
* Click on `Add`

A toaster/pop-up will indicate that the record has been added successfully. You can continue adding records to the zone.

## Configure an alias record
* Select the record type `CNAME`
* Enter a name
* Enter the targeted subdomain
* Change the TTL value if necessary
* Click on `Add`

## Configure a Mail Exchange record
* Select the record type `MX`
* Enter a name
* Enter the mail server host
* Enter the priority
* Change the TTL value if necessary
* Click on `Add`

## Configure domain point to an IP
In some cases, you need a domain to point to an IP.
For instance, you want the domain `example.com` to point to 10.0.13.37 with an
A record.

* Click on the `Add Record` button at the top right of the header
* Select the record type `A`
* Leave the name **blank**
* Enter the IP address of the server
* Change the TTL value if necessary
* click on `Add`

---

url: https://community.exoscale.com/product/networking/dns/service-boundaries/

---

# Service Boundaries - DNS

- [Limits and Quotas - DNS](https://community.exoscale.com/product/networking/dns/service-boundaries/limits-and-quotas/index.md) - DNS Limitations and Quotas
- [SLA - DNS](https://community.exoscale.com/product/networking/dns/service-boundaries/sla/index.md) - DNS Service Level Agreement

- [Pricing ↗︎](https://www.exoscale.com/pricing/#dns)

---

url: https://community.exoscale.com/product/networking/dns/service-boundaries/limits-and-quotas/

---

# Limits and Quotas - DNS

## Limits

| Usage | Limit |
| -------------------------------------------------------- | ---------------------------- |
| Max DNS Records per zone | 1000 |



## Quotas

| Usage | Quota |
| -------------------------------------------------------- | ---------------------------- |
| Zone Count | 1, 10, 50, multiples of 50 |


## Availability
DNS is available in all zones.

---

url: https://community.exoscale.com/product/networking/dns/service-boundaries/sla/

---

# SLA - DNS

## DNS Service Level Agreement (SLA)

These product-specific SLAs define the Service Availability Target for the Domain Name System (DNS) service. They apply to all Clients using the Service. Capitalized terms not defined here have the meanings set forth in the Exoscale Terms and Conditions or EUSA, whichever applies.

### SLA
| Metric | Target | Definition |
| -------- | -------- | ------------ |
| Authoritative Nameserver Availability | 99.99% Availability | The Authoritative Nameserver Infrastructure shall not fail to respond to DNS queries for more than five (5) minutes out of any twenty-four (24) hour period. An Outage is defined as the concurrent loss of all authoritative name servers in the group of systems for DNS resolution. |

### Client Responsibilities
While Exoscale is responsible for operating and maintaining the DNS service, Clients remain responsible for the following:

- Domain name registration and renewal management
- DNS zone and records export and backup
- DNS record configuration and accuracy
- TTL settings and propagation planning
- DNSSEC configuration when applicable

For a complete explanation of the shared responsibility framework between Exoscale and Clients, please see the [Exoscale Shared Responsibility Model documentation](https://community.exoscale.com/platform/compliance/shared-responsability-model/index.md).

### Exclusions
The following events shall **not** be considered a Service Outage:

- Unavailability of the Services due to Customer misuse, outside application programming, non-performance or other negligent or unlawful acts by Customer or its agents or suppliers.
- Problems with Customer's registrar or dependencies outside of the Authoritative Nameserver Infrastructure.
- Network unavailability outside of the DNSimple or Exoscale infrastructure.
- Malicious acts by a third party against Customer or against its authorized agents or suppliers.
- Force majeure events.
- **Regularly Scheduled Maintenance**: Any scheduled maintenance on the Exoscale DNS infrastructure of which Clients are notified at least 24 hours in advance. Maintenance notices are published on the [Exoscale Status Page](https://exoscalestatus.com/).

For the complete list of SLA exclusions, please refer to the [General Exoscale Terms and Conditions](https://www.exoscale.com/terms/) or [EUSA](https://www.exoscale.com/eusa/), whichever applies.

### Retribution
The standard retribution and SLA credit schemes apply for this product as described under [General Exoscale Terms and Conditions](https://www.exoscale.com/terms/) or [EUSA](https://www.exoscale.com/eusa/), whichever applies. The Service Credits shall be the sole remedy in case of non-meeting the SLA. In the event that the Monthly Uptime Percentage for Exoscale DNS falls below the committed Service Level Objective, the Client will be eligible for service credits as follows:
| Monthly Uptime Percentage | Service Credit Percentage of Monthly Service Fees for Affected Resources |
| -------- | -------- |
| from 99.99% to 98.3% | 50% |
| below 98.3% | 100% |

#### Claim Service Credit

To request a service credit, refer to the Service Unavailability Credit section of the [Exoscale Terms and Conditions](https://www.exoscale.com/terms/) or the [EUSA](https://www.exoscale.com/eusa/), whichever applies.

---

url: https://community.exoscale.com/product/networking/dns/reference/

---

# Reference - DNS

- [API DNS](https://community.exoscale.com/reference/api/dns/index.md) - All operations on DNS. (external)
- [CLI DNS](https://community.exoscale.com/reference/cli/exo/dns/index.md) - All commands on DNS. (external)
