Skip to main content

Domain names

Radix supports several domain names for each application component. Each domain name uses details from your application and the Radix cluster hosting it.

Domain name elements:

  • component-name: Component name, e.g. frontend
  • app-name: Application name, e.g. myapp
  • env-name: Environment name, e.g. production
  • cluster-name: Used only in canonical name; refers to the underlying Kubernetes cluster, e.g. eu-18. This value may change and is for debugging only.
  • cluster-dns-zone: DNS zone for the Radix cluster, e.g. radix.equinor.com, playground.radix.equinor.com

Public name

Format:

[component-name]-[app-name]-[env-name].[cluster-dns-zone]
  • Created automatically
  • Unique for each component and environment

Examples:

  • serializer-oneapp-qa.radix.equinor.com
  • frontend-myapp-production.c2.radix.equinor.com
  • backend-myapp-production.playground.radix.equinor.com

App default alias

Format:

[app-name].app.[cluster-dns-zone]

The app default alias provides a simple, shareable domain name for your application. It points to a specific component and environment.

Examples:

  • oneapp.app.radix.equinor.com
  • otherapp.app.c2.radix.equinor.com
  • myapp.app.playground.radix.equinor.com

App alias

Format:

[subdomain].[cluster-dns-zone]

App aliases let you choose a custom subdomain within the cluster DNS zone. Most names are available on a first-come, first-served basis.

Examples:

  • oneapp.radix.equinor.com
  • otherapp.c2.radix.equinor.com
  • myapp.playground.radix.equinor.com

External alias

Format:

[a valid external DNS name]

Use an external alias to bring your own domain name to Radix. See the external alias guide for setup instructions.

Examples:

  • myapp.equinor.com
  • www.mydomain.com

Canonical name

Format:

[component-name]-[app-name]-[env-name].[cluster-name].[cluster-dns-zone]

The canonical name is the technical, authoritative domain for a component in a specific Kubernetes and Radix cluster.

  • Created automatically
  • One per component
warning

Do not use the canonical name for end users or services. The cluster-name can change without notice.

Examples:

  • serializer-oneapp-qa.eu-18.radix.equinor.com
  • frontend-myapp-production.c2-11.c2.radix.equinor.com
  • backend-myapp-production.playground-92.playground.radix.equinor.com