Cloud · AMP

Deploying Liferay DXP on AWS EKS Kubernetes Cluster

Ankita Varani · Published Apr 4, 2026 · 11 min read · View full version

Quick answer

Deploy Liferay DXP on AWS EKS by compiling a Docker image, configuring EKS node groups, mapping shared AWS EFS storage for document libraries, deploying an Ingress controller, and orchestrating pod replicas with Kubernetes deployment templates.

How Do You Build and Configure Liferay Docker Containers for Kubernetes?

Direct Answer: Create your custom Dockerfile starting from Liferay's official portal base image. Inject environment variables for cluster replication, DB connections, and storage drivers.

Create a custom Dockerfile inheriting from the official Liferay image. Copy custom configurations, patches, and client extensions into the bundle directory. Build and publish your image to AWS ECR (Elastic Container Registry).

For additional optimization strategies, visit our detailed Liferay DXP developer blog listing. For configuration specifications, consult the official Liferay Documentation portal.

Use Kubernetes ConfigMaps and Secrets to store application properties securely. Set resource limits (requests/limits) for memory and CPU inside container specs to avoid pod eviction.

Shared EFS Storage Mapping

Configure AWS EFS storage targets. Create a PersistentVolume (PV) and a PersistentVolumeClaim (PVC) mapping to your document library directory. This ensures that media uploads remain persistent when pods restart.

Writing Deployment Templates

Write your Kubernetes deployment file. Define replicas, request resources, and map env variables. Use Ingress controllers like Nginx to route external traffic to your EKS pods, ensuring SSL certificate enforcement.

Frequently asked questions

How do we handle Liferay clustering in Kubernetes?

Configure TCP multicast or JDBC-PING pinging protocols to allow Liferay pods to locate other cluster nodes automatically.

Is AWS EFS required for Liferay?

Yes. Shared media folders (document libraries) must be writable by all running Liferay pods. AWS EFS supports concurrent access.

Read the full article, with table of contents, comparison table, and author bio →