Using Marketplace Artifacts to Run Liferay in AWS

You can use AWS Marketplace artifacts to provision Liferay in AWS.

Prerequisite

Oras CLI (optional)

Launch Liferay

1. Set and export environment variables to store URLs for the Liferay Elastic Container Registry and the Liferay Helm chart Open Container Initiative registry.

      export LIFERAY_ECR_REGISTRY="709825985650.dkr.ecr.us-east-1.amazonaws.com"
      export LIFERAY_CHART_OCI="oci://${LIFERAY_ECR_REGISTRY}/liferay/liferay-aws-marketplace"
   

2. Log into the Amazon Elastic Container Registry (ECR):

      aws ecr get-login-password --region us-east-1 | helm registry login "${LIFERAY_ECR_REGISTRY}" \
          --username AWS \
          --password-stdin
   

3. Use the Amazon Marketplace to find your desired version of the Liferay Helm chart. It appears in the launch instructions for the Liferay DXP product.

   

4. Use the appropriate image tag from the liferay/dxp ECR repository for the Liferay DXP version you wish to use. To find which tags are available, you can use Oras or curl + jq.

   Oras:

   oras repo tags --last "2025.q1.16-lts-slim" docker.io/liferay/dxp | grep lts | grep slim$ | sort -r
   

   curl + jq:

   curl -s "https://hub.docker.com/v2/repositories/liferay/dxp/tags?name=lts-slim&page_size=1000" \
   	| jq '.results[].name | select((. >= "2025.q1.17-lts-slim") and (test("slim$")) and (test("nightly|rc"; "i") | not))'
   

5. Install the Liferay Helm chart to your cluster, specifying your Helm chart version and Liferay DXP image tag:

      export DXP_CHART_VERSION="[desired version]"
      export DXP_IMAGE_TAG="2025.q1.17-lts-slim"
   
      helm upgrade liferay "${LIFERAY_CHART_OCI}" \
          --create-namespace \
          --install \
          --namespace liferay-system \
          --set "liferay-aws.liferay-default.image.tag=${DXP_IMAGE_TAG}" \
          --set "liferay-aws.liferay-default.serviceAccount.annotations.eks\.amazonaws\.com/role-arn=${AWS_SA_ROLE_ARN}" \
          --version "${DXP_CHART_VERSION}"
   

Warning

If the image tag is left unset, the chart installs the latest Liferay DXP image tag available on Docker Hub. Select an image with care; changing this value later could require a migration.

Note

Refer to the Liferay Helm Chart Reference for the available values. For further information see the Helm documentation.

Excellent! Liferay now runs, but it’s not yet exposed to the Internet. Your next step does that and configures it for production use. See Making Liferay Public in AWS.