Capability

DXP Self-Hosted Installation, Maintenance, and Administration

In addition to SaaS and PaaS deployment approaches for Liferay DXP, you can also opt to self-host Liferay DXP. Self-hosting gives you flexibility to deploy Liferay DXP on-premises or to a cloud computing provider of your choice, giving you complete control over deployment, infrastructure, and maintenance.

Category
Category
Starting with a Docker Image
Starting with a Docker Image The latest versions of Liferay are available as Docker images on Docker Hub. They're in two categories: Liferay/Portal Liferay/DXP Follow the steps below to...
3.0 Breaking Changes
3.0 Breaking Changes This is a chronological list of changes that break existing functionality, APIs, or contracts with third party Liferay Commerce developers or Users in Commerce 3.0. We try our...
3.0 Release Notes
3.0 Release Notes Release Highlights Compatibility with Liferay DXP 7.3 Liferay Commerce 3.0 is compatible with the latest version of Liferay DXP. Leverage the new experience management, content...
Installation and Upgrades
Installation and Upgrades Liferay DXP 7.3 and Below Liferay Commerce is a digital commerce platform built on Liferay DXP. See the prerequisites and available options for installing, deploying, and...
4.0 Breaking Changes
4.0 Breaking Changes This document presents a chronological list of changes that break existing functionality, APIs, or contracts with third party Liferay Commerce developers or users in Commerce...
Activating Liferay Commerce Enterprise
Activating Liferay Commerce Enterprise Starting with Liferay DXP/Portal 7.3, Commerce ships with all Liferay bundles and Docker containers and doesn't require a separate installation. However, the...
Upgrading Liferay Commerce
Upgrading Liferay Commerce To enhance the quality of your experience with Liferay Commerce, Liferay provides periodic product upgrades with bug fixes and new features. Users should consider...
Maintenance Versions
Maintenance Versions Fix Packs are released on a periodic basis and include bug and security fixes. If you are installing a fix pack to an installation that has custom code deployed, we recommend...
Installing Commerce 2.1 and Below
Installing Commerce 2.1 and Below Previous releases of Liferay Commerce required additional installation steps that are no longer necessary on Commerce 3.x and above. Prerequisites Before...
Using the Liferay Commerce Docker Image
Using the Liferay Commerce Docker Image The latest version Liferay Commerce is available as a docker image. Follow these steps to download the latest Docker image release of Liferay Commerce and...
Using the Liferay Commerce Tomcat Bundle
Using the Liferay Commerce Tomcat Bundle The Liferay Commerce bundle is available for download from the Liferay Commerce Community Downloads page. The bundle contains the latest version of Liferay...
Deploying Liferay Commerce to an Existing Liferay Installation
Deploying Liferay Commerce to an Existing Liferay Installation This article documents how to deploy Liferay Commerce to an existing Liferay DXP instance. Because Liferay Commerce is built on...
Installing a Liferay-Tomcat Bundle
Installing a Liferay-Tomcat Bundle The Tomcat Bundle includes the Apache Tomcat application server with Liferay DXP/Portal pre-deployed. It's the easiest, fastest way to install Liferay on...
Self-Hosted Installation and Upgrades
Self-Hosted Installation and Upgrades Liferay's flexibility makes it possible to host it in any way you choose: on any Kubernetes-based cloud platform via Helm charts and Terraform scripts, on...
Installing Liferay On A Local Server
Installing Liferay On A Local Server Liferay runs on an application server. There are three ways to host Liferay on a local machine: Using a Docker container Using a Liferay Tomcat bundle On a...
Configuring a Database
Configuring a Database By default for demonstration purposes, Liferay DXP/Portal is configured to use an embedded HSQL database. Beyond demonstration purposes, we recommend using a full-featured,...
Installing Liferay on an Application Server
Installing Liferay on an Application Server You can install Liferay DXP or Liferay Portal on any supported application server. This is typically the most practical installation type to use in...
Installing Earlier Liferay Versions on JBoss EAP
Installing Earlier Liferay Versions on JBoss EAP Liferay DXP 2025.Q2/Portal 2025.Q1 or below Installing on JBoss EAP requires installing the DXP WAR, installing dependencies, configuring JBoss,...
Installing Earlier Liferay Versions on Wildfly
Installing Earlier Liferay Versions on Wildfly Liferay DXP 2025.Q2/Portal 2025.1 or below Installing on WildFly requires installing the DXP WAR, installing dependencies, configuring WildFly, and...
Installing on Tomcat
Installing on Tomcat Liferay DXP 2025.Q3+/Portal 2026.Q1+ For pre-Jakarta Liferay versions, see Installing Earlier Versions on Tomcat. Using a Liferay-Tomcat bundle or Docker image is the...
Installing on JBoss EAP
Installing on JBoss EAP Liferay DXP 2025.Q3+/Portal 2026.Q1+ For pre-Jakarta Liferay versions, see Installing Earlier Versions on JBoss EAP. Installing on JBoss EAP requires installing the DXP...
Setting Up JNDI on Tomcat
Setting Up JNDI on Tomcat Liferay 7.4+ To set up JNDI resources, you must put the necessary JDBC drivers in the Tomcat lib folder (i.e. tomcat-9.0.56/lib). For example, if you use an Oracle...
Installing Earlier Liferay Versions on WebLogic
Installing Earlier Liferay Versions on WebLogic Liferay DXP 2025.Q2/Portal 2025.Q1 or below If you are using WebLogic as your application server, it is highly recommended to install DXP to a...
Installing Earlier Liferay Versions on Tomcat
Installing Earlier Liferay Versions on Tomcat Liferay DXP 2025.Q2/Portal 2025.Q1 or below Using a Liferay-Tomcat bundle or Docker image is the fastest way to get started using Liferay DXP. This...
Installing Earlier Liferay Versions on Application Servers
Installing Earlier Liferay Versions on Application Servers As new Liferay versions are released, their dependencies and installation steps change. Liferay made a big change for DXP with the 2025.Q3...
Installing Earlier Liferay Versions on WebSphere
Installing Earlier Liferay Versions on WebSphere Liferay DXP 2024.Q1/Portal GA112 or below Compatibility with IBM WebSphere application server has been removed in 2024.Q2 and later releases. ...
Installing on WildFly
Installing on WildFly Liferay DXP 2025.Q3+/Portal 2026.Q1+ For pre-Jakarta Liferay versions, see Installing Earlier Versions on WildFly. Installing on WildFly requires installing the DXP WAR,...
AWS Managed Resources Reference
AWS Managed Resources Reference By default, Liferay uses several managed services to run background operations when hosting in AWS. These resources facilitate the provisioning and continued use of...
Liferay Helm Values Reference
Liferay Helm Values Reference Helm is configured in YAML. Below are descriptions of the Liferay default values. affinity: {} # Set Liferay DXP StatefulSet spec affinity field...
Running Liferay for the First Time
Running Liferay for the First Time Once you've installed Liferay DXP/Portal and configured a database for it, it is ready to run. Start the Server Run the startup script bundled with your...
Configuring Internally Managed Services
Configuring Internally Managed Services Internally managed services are configured and managed within the chart. These services are defined using the dependencies property: dependencies: : ...
Configuring Liferay in AWS
Configuring Liferay in AWS Since Liferay installations hosted in AWS use Helm, you must configure and customize Liferay using the Helm CLI. You can write as many .yaml files as you need. To update...
Auto-Scaling in AWS
Auto-Scaling in AWS Liferay's auto-scaling feature automatically creates and destroys replicas (nodes) in the Liferay cluster to optimize performance. You can choose the minimum and maximum number...
Running Liferay DXP in Amazon Web Services
Running Liferay DXP in Amazon Web Services There are three ways to host Liferay DXP in AWS: Installing Liferay DXP using the plain Helm chart. Installing Liferay DXP from AWS Marketplace. ...
Liferay Cloud Native Provisioning
Liferay Cloud Native Provisioning Liferay's cloud native experience is a Kubernetes-based Helm chart for portable deployment of Liferay instances to any cloud with a Kubernetes engine. This...
Configuring Externally Managed Services
Configuring Externally Managed Services Externally managed services are created, configured, and managed outside the Liferay Helm chart. Database Configuring an external database for Liferay in...
Making Liferay Public in AWS
Making Liferay Public in AWS Now that you have Liferay installed, all that's left is to make it publicly available and then configure HTTPS for secure communication. Install the nginx Ingress...
Using GovCloud to run Liferay in AWS
Using GovCloud to run Liferay in AWS Government entities can use GovCloud to provision Liferay in AWS. Subscribe to Liferay DXP Visit the AWS Marketplace. In Discover Products, find Liferay...
Using Marketplace Artifacts to Run Liferay in AWS
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 Set and export environment...
Applying a Hotfix
Applying a Hotfix Subscribers A Hotfix is a fix or collection of fixes delivered between Updates (or between Fix Packs for versions before DXP 7.3 SP3) to address a customer's confirmed critical...