Deploy a Container Web App on Amazon Lightsail


Module 3: Deploy a Container

In this module, we will deploy our container to the cloud


Now that your Amazon Lightsail container service is ready, the next step is to deploy your container.

Amazon Lightsail is able to deploy containers from public container image repositories such as Docker Hub, Amazon ECR Public Gallery, or your local machine.

In this tutorial, we will deploy directly from your local computer.

What you will accomplish

In this module, you will:
  • Push a local container image to Amazon Lightsail
  • Deploy a version of your container image on a container service

 Minimum time to complete

10 minutes

 Module prerequisites

  • AWS account with administrator-level access*
  • Recommended browser: The latest version of Chrome or Firefox

*Accounts created within the past 24 hours might not yet have access to the services required for this tutorial.


Push a local container image

The first step to deploy a container is to push a container image to Amazon Lightsail.

Open a terminal in the directory in which you created your container and enter the following command. Make sure to use the same Region in which you created your Lightsail container service.

aws lightsail push-container-image    \
    --region eu-west-3                \
    --service-name signup-application \
    --label latest                    \
    --image demo-flask-signup:latest

# the command outputs the following lines
f017a6ddb209: Pushed 
b94dee417b5e: Pushed 
37d77b23a488: Pushed 
8e77a3b871e7: Pushed 
4bc5d67b6427: Pushed 
ce8ffb5c560e: Pushed 
4226d5d0360f: Pushed 
9d1af766c818: Pushed 
d97733c0a3b6: Pushed 
c553c6ba5f13: Pushed 
48b4a40de359: Pushed 
ace9ed9bcfaf: Pushed 
764055ebc9a7: Pushed 
Digest: sha256:128f84907d30a1fb47c1888720485fa8050cc99bc1034e0cfd1f46d3b6e57e19
Image "demo-flask-signup:latest" registered.
Refer to this image as ":signup-application.latest.1" in deployments.    

The command invokes docker push to upload your image to Amazon Lightsail. It might take a couple of minutes to complete, depending on your network bandwidth.

The last line of the output is giving the internal name of your container; in our case, it's :signup-application.latest.1. Note the name, because we will need it to deploy the container onto the container service. In case you want to access the container name at a later stage, you can enter the following command:

aws lightsail get-container-images    \
    --region eu-west-3                \
    --service-name signup-application

# the command outputs the following lines
    "containerImages": [
            "image": ":signup-application.latest.1",
            "digest": "sha256:128f84907d30a1fb47c1888720485fa8050cc99bc1034e0cfd1f46d3b6e57e19",
            "createdAt": "2021-07-17T15:11:49+02:00"

Push a local container image to LightSail

Now that the container image is stored on Amazon Lightsail, we can deploy that image to the container service.

Lightsail requires the following information to create a deployment:

  • The name of the container image to deploy (:signup-application.latest.1 as returned by the previous command)
  • The network port exposed by the container (as described in the Dockerfile configuration)
  • (optional) Details of a publicly accessible network endpoint: a TCP port number and protocol; the IP will be assigned automatically.

All this information is stored in a JSON file that you need to create before the deployment.

Create a JSON file named lc.json. If you are working from the downloaded code, you will modify the existing lc.json file which is in the same directory as your container. Copy the following json into the file:

    "serviceName": "signup-application",
    "containers": {
        "signup-app-container": {
            "image": ":signup-application.latest.1",
            "ports": {
                "80": "HTTP"
    "publicEndpoint": {
        "containerName": "signup-app-container",
        "containerPort": 80

Then, deploy the container by entering the following command:

aws lightsail create-container-service-deployment \
    --region eu-west-3                            \
    --cli-input-json file://lc.json

# the command outputs the following 

    "containerService": {
        "containerServiceName": "signup-application",
        "arn": "arn:aws:lightsail:eu-west-3:012345678901:ContainerService/528a0bcf-fd14-42d4-a09a-943a241adc51",
        "createdAt": "2021-07-17T13:38:40+02:00",
        "location": {
            "availabilityZone": "all",
            "regionName": "eu-west-3"
        "resourceType": "ContainerService",
        "tags": [],
        "power": "nano",
        "powerId": "nano-1",
        "state": "DEPLOYING",
        "scale": 2,
        "nextDeployment": {
            "version": 1,
            "state": "ACTIVATING",
            "containers": {
                "signup-app-container": {
                    "image": ":signup-application.latest.1",
                    "command": [],
                    "environment": {},
                    "ports": {
                        "80": "HTTP"
            "publicEndpoint": {
                "containerName": "signup-app-container",
                "containerPort": 80,
                "healthCheck": {
                    "healthyThreshold": 2,
                    "unhealthyThreshold": 2,
                    "timeoutSeconds": 2,
                    "intervalSeconds": 5,
                    "path": "/",
                    "successCodes": "200-499"
            "createdAt": "2021-07-17T15:31:01+02:00"
        "isDisabled": false,
        "principalArn": "arn:aws:iam::577312533299:role/amazon/lightsail/eu-west-3/containers/signup-application/1jetjd21p8qshe57seuh71tnrnn29ps77lnno20sbgl2ghbuc0r0",
        "privateDomainName": "signup-application.service.local",
        "url": ""

Notice the "state": "DEPLOYING" status. After a while, the state becomes ACTIVE. The deployment takes a few minutes to complete. You can check the state of your deployment using the following command:

# while deploying
aws lightsail get-container-services      \
    --region eu-west-3                    \
    --query "containerServices[].nextDeployment.state"

# once deployed
aws lightsail get-container-services      \
    --region eu-west-3                    \
    --query "containerServices[].currentDeployment.state" 

Test your deployment

To test your deployment, first retrieve the URL Lightsail created for you. Open a terminal and enter the following command:

aws lightsail get-container-services        \
    --region eu-west-3                      \
    --query "containerServices[].url" 

# the command outputs something like the below 

Open your favorite browser and point it to your deployment URL.

Alternatively, you can use cURL to test the endpoint from the command line:

curl -I

HTTP/2 200 
date: Sat, 17 Jul 2021 13:38:04 GMT
content-type: text/html; charset=utf-8
content-length: 4579
server: nginx/1.21.1

Congrats, your container is now deployed onto Amazon Lightsail.


In this module, you learned how to deploy a container to Amazon Lightsail. In the next module, you are going to learn how to update your container.

Up Next: Update Container

Was this page helpful?