‹ Return to How tos

Enabling and managing custom domains for your Amazon Lightsail container services

Last updated: November 1, 2022

Enable custom domains for your Amazon Lightsail container service to use your registered domain names with your service. Before you enable custom domains, your container service accepts traffic only for the default domain that is associated with your service when you first create it (e.g., containerservicename.123456abcdef.us-west-2.cs.amazonlightsail.com). When you enable custom domains, you choose the Lightsail SSL/TLS certificate that you created for the domains that you want to use with your container service, and then you choose the domains you want to use from that certificate. After you enable custom domains, your container service accepts traffic for all of the domains that are associated with the certificate that you chose.

Important

If you choose a Lightsail container service as the origin of your distribution, Lightsail automatically adds the default domain name of your distribution as a custom domain on your container service. This enables traffic to be routed between your distribution and your container service. However, there are some circumstances in which you might need to manually add the default domain name of your distribution to your container service. For more information, see Add the default domain of an Amazon Lightsail distribution to Lightsail container service.

Contents

Container service custom domain limits

The following limits apply to container service custom domains:

  • You can use up to 4 custom domains with each of your Lightsail container services, and you cannot use the same domains on more than one service.

  • If you use a Lightsail DNS zone to manage the DNS of your domain, then you can route traffic for the apex of your domain (e.g., example.com) and for subdomains (e.g., www.example.com) to your container services.

Prerequisites

Before you get started, you need to create a Lightsail container service. For more information, see Creating Amazon Lightsail container services.

You also should have created and validated an SSL/TLS certificate for your container service. For more information, see Creating SSL/TLS certificates for your Amazon Lightsail container services and Validating SSL/TLS certificates for your Amazon Lightsail container services.

View custom domains for a container service

Complete the following procedure to view the custom domains that are currently enabled for your container service.

  1. Sign in to the Lightsail console.

  2. On the Lightsail home page, choose the Containers tab.

  3. Choose the name of the container service for which you want to view the enabled custom domains.

  4. Locate the custom domain values in the heading of the container service management page, as shown in the following example. These are the custom domains that are currently enabled for the container service.

    Custom domains for a container service in the Lightsail console
  5. On the container service management page, choose the Custom domains tab.

    The custom domains being used under each attached certificate, are listed under the Custom domain SSL/TLS certificates section of the page. The certificates currently attached to your container service, are listed under the Attached certificates section.

Enable custom domains for a container service

Complete the following procedure to enable custom domains for your Lightsail container service by attaching a certificate to your service.

  1. Sign in to the Lightsail console.

  2. On the Lightsail home page, choose the Containers tab.

  3. Choose the name of the container service for which you want to enable custom domains.

  4. On the container service management page, choose the Custom domains tab.

    The Custom domains page displays the SSL/TLS certificates currently attached to your container service, if any.

  5. Choose Attach certificate.

    If you have no certificates, then you must first create an SSL/TLS certificate for your domains, and then validate it, before you can attach it to your container service. For more information, see Creating SSL/TLS certificates for your Amazon Lightsail container services.

  6. In the dropdown menu that appears, select a valid certificate for the domain(s) that you want to use with your container service.

  7. Verify the certificate information is correct, then choose Attach.

  8. Add a domain assignment to the DNS of your domain to point the domain to your container service.

    The container service's Status will change to Updating. After the status changes to Ready, the certificate's domain will appear in the Custom domains section. Choose Add domain assignment to point the domain to your container service

  9. Choose Add assignment. After a few moments, traffic for the domain that you selected will begin to be accepted by your container service.

    After you've added the domain assignment, open a new browser window and browse to the custom domain that you enabled for your container service. The application that is running on your container service, if any, should load.

Disable custom domains for a container service

Complete the following procedure to disable custom domains for your Lightsail container service by detaching a certificate from your service, or by deselecting a previously selected domain.

  1. Sign in to the Lightsail console.

  2. On the Lightsail home page, choose the Containers tab.

  3. Choose the name of the container service for which you want to disable custom domains.

  4. On the container service management page, choose the Custom domains tab.

    The Custom domains page displays the SSL/TLS certificates currently attached to your container service, if any.

  5. Choose one of the following options:

    1. Choose Configure container service domains to either deselect domains that were previously selected, or to select more domains that are associated to the container service.

    2. Choose Detach to detach the certificate from the container service, and remove all of its associated domains from the service.

    Important

    If you haven't already done so, modify the DNS records of your domain so that traffic routes stops routing to your container service and instead routes to another resource.

Additional information about container services

These are the general steps to manage your Lightsail container service after it's up and running:

  1. Get familiar with all of the elements of Lightsail container services. For more information, see Container services in Amazon Lightsail.

  2. Create your container service in your Lightsail account. For more information, see Creating Amazon Lightsail container services.

  3. If you plan to use container images from a public registry, find container images from a public registry such as the Amazon ECR Public Gallery. For more information about Amazon ECR Public, see What Is Amazon Elastic Container Registry Public? in the Amazon ECR Public User Guide.

  4. If you plan to push container images from your local machine to your service, install software on your local machine that you need to create your own container images and push them to your Lightsail container service. For more information, see the following guides:

  5. Create a deployment in your container service that configures and launches your containers. For more information, see Creating and managing deployments for your Amazon Lightsail container services.

  6. View previous deployments for your container service. You can create a new deployment using a previous deployment version. For more information, see Viewing and managing deployment versions of your Amazon Lightsail container services.

  7. View the logs of containers on your container service. For more information, see Viewing the container logs of your Amazon Lightsail container services.

  8. Create an SSL/TLS certificate for the domains that you want to use with your containers. For more information, see Creating SSL/TLS certificates for your Amazon Lightsail container services.

  9. Validate the SSL/TLS certificate by adding records to the DNS of your domains. For more information, see Validating SSL/TLS certificates for your Amazon Lightsail container services.

  10. Enable custom domains by attaching a valid SSL/TLS certificate to your container service. For more information, see Enabling and managing custom domains for your Amazon Lightsail container services.

  11. Monitor the utilization metrics of your container service. For more information, see Viewing container service metrics in Amazon Lightsail.

  12. (Optional) Scale the capacity of your container service vertically, by increasing its power specification, and horizontally, by increasing its scale specification. For more information, see Changing the capacity of your Amazon Lightsail container services.

  13. Delete your container service if you're not using it to avoid incurring monthly charges. For more information, see Deleting Amazon Lightsail container services.