How to configure a domain

Use Azion Domains to enable browser access to your app, allowing user traffic and metrics tracking.

Important — We’re releasing a significant update to our platform. To learn more about the changes and required migration steps, see the API v4 rollout page.

With Azion, you can create and run applications directly at the edge. To allow access to your application through the browser and start receiving users and monitoring metrics, you need to configure a domain.

To create a free domain address for your application in the format xxxxxxxxxx.map.azionedge.net, follow the steps in the appropriate tab below. There are separate instructions for the legacy Domains settings and the new Workloads product.

In this guide, there are separate instructions for API v3 and API v4. If you’re not sure which steps apply to your account, see the Verify Your Account Migration guide to determine if your account has already been migrated.

Configuring a domain with Azion

To create a Workload:

Access Azion Console > Workloads.
Click the + Workload button.
Give your Workload a name.
Select the Infrastructure for your Workload: Production Infrastructure or Staging Infrastructure (test environment).
Define your application hostnames in the Subdomain and Domain fields. You can use custom domain addresses to link to your application.
In Applications, select your Applications.
In Firewall, select your Firewall.
In Digital Certificate, select, create a new, or use the Azion SAN certificate if you’re aiming to use the Azion Custom Domain or the Workload Domain.
Click the Save button.

Wait a few minutes for your new Workload to propagate and access your xxxxxxxxxx.map.azionedge.net address to see your Application online.

Access Azion Console > Domains.
Click the + Domain button.
Give your domain a name.
Select the Environment Type for your domain: Global Edge Network (production environment) or Staging Network (test environment).
In Applications, select your application.
In Firewall, select your firewall.
Disable the CNAME access only switch. This’ll enable users to access your application using the xxxxxxxxxx.map.azionedge.net address.
In the CNAME field, you may list custom domain addresses to link to your application.
In Digital Certificate, select the Azion SAN certificate.
Click the Save button.

Wait a few minutes for your new domain to propagate to the edge nodes and access your xxxxxxxxxx.map.azionedge.net address to see your application online.

Run the following POST request in your terminal, replacing [TOKEN VALUE] with your personal token to create a new Workload.

curl --request POST --url https://api.azion.com/v4/workspace/workloads --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"name": "Example CN0 DC0",

"active": true,

"infrastructure": 1,

"protocols": {

"http": {

"versions": [

"http1",

"http2"

]

}

},

"workload_domain_allow_access": true

}

Key	Description
`name`	Sets the value as the name of the domain entry with Azion. You may modify this value to fit your needs, since it does not represent a domain address.
`workload_domain_allow_access`	When set to `true`, enables access via the `xxxxxxxxxx.map.azionedge.net` Azion address.
`infrastructure`	Infrastructure for your Workload: Production Infrastructure (1) or Staging Infrastructure (2)
`digital_certificate_id`	When `null`, selects the Azion SAN certificate. You can also associate a digital certificate to your Workload.

You’ll receive a response similar to:

{

"state": "pending",

"data": {

"id": <workload_id>,

"name": "Example CN0 DC0",

"active": true,

"last_editor": "your-email@example.com",

"last_modified": "2025-07-25T18:58:25.817955Z",

"infrastructure": 1,

"tls": {

"certificate": null,

"ciphers": 7,

"minimum_version": "tls_1_3"

},

"protocols": {

"http": {

"versions": [

"http1",

"http2"

],

"http_ports": [

80

],

"https_ports": [

443

],

"quic_ports": null

}

},

"mtls": {

"verification": null,

"certificate": null,

"crl": null

},

"domains": [],

"workload_domain_allow_access": true,

"workload_domain": "xxxxxxxxxxx.azionedge.net",

"product_version": "1.0"

}

Copy the URL in the workload_domain value and paste it in a text editing app to access later.
Now you must bind the created Workload to an Application. This is done by creating a Workload Deployment. Run the following POST request in your terminal, replacing [TOKEN VALUE] with your personal token, <edge_application_id> with the ID of the desired Application and <workload_id> with the ID of the Workload you created on the previous step.

curl --request POST --url https://api.azion.com/v4/workspace/workloads/<workload_id>/deployments --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"name": "My Workload Deployment",

"current": true,

"active": true,

"strategy": {

"type": "default",

"attributes": {

"edge_application": <edge_application_id>

}

The workload_domain received in the response carries your application’s Azion domain address as a string. Wait a few minutes for the changes to propagate and paste its value without the double quotes (") in your browser to access your application.

Check the Azion API documentation to know more about all features available via API.

Run the following POST request in your terminal, replacing [TOKEN VALUE] with your personal token, the <edge_application_id> variable with the ID of your application:

curl --location 'https://api.azionapi.net/domains' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]'--header 'Content-Type: application/json' --data {

"name": "Example CN0 DC0",

"cname_access_only": false,

"digital_certificate_id": null,

"edge_application_id": <edge_application_id>

}

Key	Description
`name`	Sets the string in value as a name of the domain entry with Azion. You may modify this value to fit your needs, since it does not represent a domain address.
`cname_access_only`	When set to `false`, enables access via the Azion address.
`digital_certificate_id`	When `null`, selects the Azion SAN certificate. You can also associate a digital certificate to your domain.
`edge_application_id`	The ID of the application linked to the domain.

You’ll receive a response similar to:

{

"results": {

"id": <domain_id>,

"name": "Example CN0 DC0",

"cnames": [],

"cname_access_only": false,

"digital_certificate_id": null,

"edge_application_id": <edge_application_id>,

"is_active": true,

"domain_name": "xxxxxxxxxx.map.azionedge.net",

"is_mtls_enabled": false,

"mtls_verification": "enforce",

"mtls_trusted_ca_certificate_id": null

}

The domain_name received in the response carries your application’s Azion domain address as a string. Wait a few minutes for the changes to propagate and paste its value without the double quotes (") in your browser to access your application.

Check the Azion API documentation and the OpenAPI specification to know more about all features available via API.

Linking a custom domain to your application

In addition to the default Azion domain, you have the option to associate a custom domain in CNAME format, such as yourdomain.com, with your application. This allows you to customize the domain name that users will use to access your application.

When a user enters the custom domain name in their browser, a DNS lookup process takes place. During the DNS lookup, the user’s browser sends a request to a DNS server to find the IP address associated with the custom domain. The DNS server checks its database to find the corresponding IP address for the custom domain name. If the custom domain is configured to point to the Azion domain, the DNS server returns the IP address of the nearest edge node in the Azion network.

Once the user’s browser receives the IP address, it establishes a connection with the appropriate edge node. The edge node then serves the requested content, and the user’s browser displays the application.

You can choose to customize your domain by associating a domain record or migrating your name resolution to Azion.