How to use the apex(root) domain on OpenShift applications

Solution Verified - Updated -


  • Red Hat OpenShift Service on AWS [ROSA]
    • 4.x
  • Red Hat OpenShift Dedicated [OSD]
    • 4.x
  • Red Hat OpenShift Container Platform [RHOCP]
    • 4.x


  • How to configure my applications on OpenShift to use my apex (root) domain?


Disclaimer: Links contained herein to external website(s) are provided for convenience only. Red Hat has not reviewed the links and is not responsible for the content or its availability. The inclusion of any link to an external website does not imply endorsement by Red Hat of the website or their entities, products or services. You agree that Red Hat is not responsible or liable for any loss or expenses that may result due to your use of (or reliance on) the external site or content.

Note 1: This procedure has been verified by using AWS Route53. For any other DNS providers, please check the feasibility directly with the provider's support team.

Note 2: For inquires and/or issues with AWS Route53, please refer to the AWS Customer Support.

  1. From Red Hat perspective, the only required configuration is to have created a custom domain, which will have something like this:

    kind: CustomDomain
      name: example-com
        name: example-com-tls
        namespace: example
      scope: External
  2. With the custom domain in Ready state and the Endpoint already provisioned, if required, a CNAME for the subdomains can be added to the DNS hosted zone:

    *.<domain>               CNAME    Simple    -    <endpoint>
  3. As it is not possible to create a CNAME record using the apex domain, the alternative is to create an A record with alias enabled pointing to the AWS Load Balance:

    1. Name:
    2. Type: A
    3. Alias Enabled: True
    4. Choose Alias to Application and Classic Load Balancer
    5. Choose same region as the cluster
    6. Choose the name of the load balance created by the custom domain (something like "")
  4. Then create the route by using the apex domain:

    $ oc create route edge --service=example-app example-app --hostname

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.