Using Custom Domains - AWS OpsWorks

Using Custom Domains


AWS OpsWorks Stacks is no longer accepting new customers. Existing customers will be able to use the OpsWorks console, API, CLI, and CloudFormation resources as normal until May 26, 2024, at which time they will be discontinued. To prepare for this transition, we recommend you transition your stacks to AWS Systems Manager as soon as possible. For more information, see AWS OpsWorks Stacks End of Life FAQs and Migrating your AWS OpsWorks Stacks applications to AWS Systems Manager Application Manager.

If you host a domain name with a third party, you can map that domain name to an app. The basic procedure is as follows:

  1. Create a subdomain with your DNS registrar and map it to your load balancer's Elastic IP address or your app server's public IP address.

  2. Update your app's configuration to point to the subdomain and redeploy the app.


Make sure you forward your unqualified domain name (such as to your qualified domain name (such as so that both map to your app.

When you configure a domain for an app, it is listed as a server alias in the server's configuration file. If you are using a load balancer, the load balancer checks the domain name in the URL as requests come in and redirects the traffic based on the domain.

To map a subdomain to an IP address
  1. If you are using a load balancer, on the Instances page, click the load balancer instance to open its details page and get the instance's Elastic IP address. Otherwise, get the public IP address from the application server instance's details page.

  2. Follow the directions provided by your DNS registrar to create and map your subdomain to the IP address from Step 1.


If the load balancer instance terminates at some point, you are assigned a new Elastic IP address. You need to update your DNS registrar settings to map to the new Elastic IP address.

AWS OpsWorks Stacks simply adds the domain settings to the app's deploy attributes. You must implement a custom recipe to retrieve the information from the node object and configure the server appropriately. For more information, see Cookbooks and Recipes.