Create and attach a Lightsail web address
Create a Lightsail web address, such as mysite.amazonlightsail.com, and then
attach it to a resource to serve your content at the web address over HTTPS. You can also add a
web address when you create a distribution. For instructions, see Add a web address when you create a
distribution.
Prerequisites
Before you attach a web address, set up the resource that you want to attach it to, and make sure that you have the following:
-
A Lightsail distribution with the Deployed status, and you've configured an origin resource for it, such as an instance, bucket, container service, or load balancer. Web addresses attach to distributions. For instructions, see Create and configure a distribution.
-
The distribution isn't currently using a custom domain and isn't attached to a web address. If it uses a custom domain, disable custom domains first. For instructions, see Switch between a web address and a custom domain.
-
If the origin of your distribution is a container service, it must have 3 or fewer domains (shown as custom domains in the console) before you attach. A container service can have up to 4 domains, and Lightsail adds your web address as one of them. For more information, see Add the default domain of a distribution to a Lightsail container service.
-
If you use IAM policies to control access to Lightsail, you need the following permissions:
-
lightsail:CreateSubdomain– To create a web address. -
lightsail:UpdateSubdomainAssociation– To attach a web address. -
lightsail:AttachCertificateToDistributionon the distribution – To attach a web address, because Lightsail attaches the certificate of your web address for you.
For more information, see Grant least-privilege permissions with IAM identity policies in Lightsail.
-
Web address naming rules
Choose your name carefully. You can't rename a web address after you create it. Web address names:
-
Must be unique across all AWS accounts.
-
Must contain 1 to 39 characters, including periods.
-
Can have one or two parts, separated by a period (.), such as
mysiteorblog.mysite. A name with two parts creates a child web address. For more information, see Child web addresses. -
Can include lowercase letters (a-z), numbers (0-9), and hyphens (-).
-
Must start and end each part with a lowercase letter or number.
-
Can't start a part with
xn--. -
Can't use a reserved name. Lightsail reserves names such as brand names, trademarks, AWS service names, and common words. Common words, such as
blog, are reserved only as one-part names, so you can use one as the first part of a child web address, such asblog.mysite.
AWS can take down a web address, or take other action described in the AWS Acceptable Use Policy
Create a web address using the Lightsail console
Complete the following procedure to create a web address using the Lightsail console.
-
Sign in to the Lightsail console
. -
In the left navigation pane, choose Lightsail web addresses.
-
Choose Create web address.
-
For Web address name, enter a name for your web address. For the naming rules, see Web address naming rules.
-
(Optional) Choose Check availability to check whether the name is available.
-
Choose Create web address.
Your web address appears on the Lightsail web addresses page with the Creating status. When your web address is ready, the status changes to Unattached.
NoteTo avoid charges, attach your web address to a resource after you create it. For instructions, see Attach a web address using the Lightsail console.
Each month, you get 24 hours of free unattached web address time. After that, we charge USD $1 per month for each unattached web address. For more information, see What do Lightsail web addresses cost?.
Attach a web address using the Lightsail console
Complete the following procedure to attach a web address to a resource. Make sure that the resource meets the prerequisites.
-
Sign in to the Lightsail console
. -
In the left navigation pane, choose Lightsail web addresses.
-
Choose the vertical ellipsis (⋮) icon next to the web address that you want to attach, and then choose Attach to a resource.
-
For Select distribution, choose the resource. Resources that you can't attach the web address to are unavailable, and the reason is shown.
-
Choose Attach web address.
The status of your web address changes to Attaching. An attach usually takes about a minute. The first time that you attach a web address, setting up HTTPS for it can take a few minutes longer. When the status changes to Attached, visitors can reach your resource at your web address, such as
https://mysite.amazonlightsail.com.NoteIf you visited your web address in a browser before it was attached, it can take up to 15 minutes after the status changes to Attached before it works for you.
-
(Optional) If the origin of your distribution is a WordPress instance, configure WordPress to use your web address. For instructions, see Configure WordPress with a Lightsail content delivery network.
If your instance uses WordPress packaged by Bitnami, see the Bitnami version of that tutorial.
You can also attach a web address from the Getting started tab or the Domains tab of your distribution's management page. For more information, see Attach a Lightsail web address to your distribution.
If an attach fails
If Lightsail can't attach your web address, for example because the distribution was deleted or didn't finish deploying, your web address returns to the Unattached status. Check that the resource meets the prerequisites, and then attach the web address again.
Create a child web address for an existing web address
Complete the following procedure to create a child web address, such as
blog.mysite.amazonlightsail.com, under a web address that you have.
-
Sign in to the Lightsail console
. -
In the left navigation pane, choose Lightsail web addresses.
-
Choose the vertical ellipsis (⋮) icon next to the web address that you want to create a child web address for, and then choose Create child web address.
-
For Web address name, enter the first part of the child web address, such as
blog.
-
Choose Create child web address.
Your child web address has the Creating status, and then Unattached. Attach it to a different resource than its parent, because a resource can have only one web address.
Claim an implicit web address
An implicit web address is reserved for your account because you created a child web address under it. Claim it to make it a web address that you can attach to a resource.
After you claim an implicit web address, it's charged like any other web address while it isn't attached, and it counts toward your quota.
-
Sign in to the Lightsail console
. -
In the left navigation pane, choose Lightsail web addresses.
-
Choose the vertical ellipsis (⋮) icon next to the web address with the Implicit status, and then choose Claim this web address.
-
Choose Claim web address.
Your web address has the Creating status, and then Unattached. To avoid charges, attach it to a distribution.
Create and attach a web address using the AWS CLI
Complete the following procedure to check whether a name is available, create a web address, and attach it to a distribution using the AWS CLI.
In the Lightsail API and AWS CLI, web addresses are called subdomains.
You can run the following commands in AWS CloudShell. CloudShell is a browser-based, pre-authenticated shell that you can launch directly from the Lightsail console. With CloudShell, you can run AWS CLI commands using your preferred shell, such as Bash, PowerShell, or Z shell, without downloading or installing command line tools. For more information, see Manage Lightsail resources with AWS CloudShell.
To use the AWS CLI on your own computer, install and configure it first. For instructions, see Set up and configure the AWS CLI for Lightsail operations.
-
Open a Terminal, AWS CloudShell, or Command Prompt window.
-
Enter the following command to check whether a name is available.
aws lightsail check-subdomain-availability --subdomain-nameSubdomainName--region us-east-1In the command, replace
SubdomainNamewith the name that you want, such asmysite.If the name is available, you should see output similar to the following.
{ "subdomainName": "mysite", "available": true } -
Enter the following command to create the web address.
aws lightsail create-subdomain --subdomain-nameSubdomainName--region us-east-1In the command, replace
SubdomainNamewith the name of your web address. For more information, see create-subdomain in the AWS CLI Command Reference.If successful, you should see output similar to the following.
{ "subdomain": { "subdomainName": "mysite", "fqdn": "mysite.amazonlightsail.com", "arn": "arn:aws:lightsail:us-east-1:123456789012:Subdomain/83e5fe9b-1234-5678-90ab-12345EXAMPLE", "depth": 1, "state": "CREATING", "createdAt": 1793400000.0, "location": { "availabilityZone": "all", "regionName": "us-east-1" } }, "operation": { "id": "a1b2c3d4-1234-5678-90ab-12345EXAMPLE", "resourceName": "mysite", "resourceType": "Subdomain", "createdAt": 1793400000.0, "location": { "availabilityZone": "all", "regionName": "us-east-1" }, "isTerminal": false, "operationType": "CreateSubdomain", "status": "Started" } } -
Enter the following command to confirm that the state of your web address is
UNATTACHED.aws lightsail get-subdomains --subdomain-nameSubdomainName--region us-east-1 -
Enter the following command to get the Amazon Resource Name (ARN) of the distribution.
aws lightsail get-distributions --distribution-nameDistributionName--region us-east-1In the command, replace
DistributionNamewith the name of your distribution. Make a note of thearnvalue in the output. -
Enter the following command to attach the web address to the distribution.
aws lightsail update-subdomain-association --subdomain-nameSubdomainName--action ASSOCIATE --target-resource-arnDistributionArn--region us-east-1In the command, replace
SubdomainNamewith the name of your web address, andDistributionArnwith the ARN of the distribution. For more information, see update-subdomain-association in the AWS CLI Command Reference.The command returns your web address with the
ATTACHINGstate, and an operation. -
Enter the following command to confirm that the state of your web address is
ATTACHED.aws lightsail get-subdomains --subdomain-nameSubdomainName--region us-east-1