Capability

DXP Self-Hosted Installation, Maintenance, and Administration

Search Bar

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
  • Capability
  • Deployment Approach
  • Feature
  • Resource Type
Category
  • Capability
  • Deployment Approach
  • Feature
  • Resource Type
Installation and Upgrades
Official Documentation
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...
3.0 Release Notes
Official Documentation
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...
3.0 Breaking Changes
Official Documentation
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...
4.0 Breaking Changes
Official Documentation
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...
Using the Liferay Commerce Docker Image
Official Documentation
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...
Deploying Liferay Commerce to an Existing Liferay Installation
Official Documentation
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 Commerce 2.1 and Below
Official Documentation
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...
Maintenance Versions
Official Documentation
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...
Upgrading Liferay Commerce
Official Documentation
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...
Activating Liferay Commerce Enterprise
Official Documentation
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...
Using the Liferay Commerce Tomcat Bundle
Official Documentation
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...
Starting with a Docker Image
Official Documentation
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...
Using Liferay Docker Images
Official Documentation
Using Liferay Docker Images Docker Hub hosts Liferay DXP and Liferay Portal Docker images, bundled with Tomcat on Linux. The Liferay Docker Hub pages provide image details and tags for the...
Building Liferay Docker Images
Official Documentation
Building Liferay Docker Images Liferay is open-source and fully customizable. You can create your own Liferay Docker images using Dockerfiles to suit the needs of your installation. For example,...
Configuring Containers
Official Documentation
Configuring Containers Everything that is configurable in a Liferay installation is configurable in a Liferay Docker container. Here are the most common things to configure: JVM Options Portal...
Docker Packages
Official Documentation
Docker Packages These are the packages Liferay installs in the Ubuntu OS to support a full Liferay DXP environment. This list includes neither the JDK nor the dependencies the packages require. ...
Installing Apps and Other Artifacts to Containers
Official Documentation
Installing Apps and Other Artifacts to Containers Applications and other artifacts (such as DXP activation keys) are installed to DXP Docker containers via the container's /mnt/liferay/deploy...
Patching DXP in Docker
Official Documentation
Patching DXP in Docker Liferay patches fix DXP issues and the Patching Tool applies the patches. On Docker Hub, Liferay provides images pre-populated with each new Fix Pack, Security Fix Pack, and...
Docker Image Versions
Official Documentation
Docker Image Versions Liferay Docker image tags begin with a Liferay software version and end with an image version. [Liferay software version] [image version] For example, Liferay DXP 7.4.13...
Maintenance and Troubleshooting in Docker
Official Documentation
Maintenance and Troubleshooting in Docker The Liferay Docker container has tools for maintenance and troubleshooting out-of-the-box. You can set various environment variables to modify settings...
Running Scripts in Containers
Official Documentation
Running Scripts in Containers If there's more that you want to do in the Liferay container beyond setting up Tomcat and Liferay files, deploying arifacts, and applying patches, you can use scripts....
Providing Files to the Container
Official Documentation
Providing Files to the Container The Liferay container uses the files you provide to execute the following use cases: Configure Liferay with .properties Files and .config files Configure Tomcat...
Container Lifecycle and API
Official Documentation
Container Lifecycle and API At a high level, the container starts Tomcat with Liferay deployed on it. Additionally, however, the container entry point provides an API for executing these use cases:...
Licensing DXP in Docker
Official Documentation
Licensing DXP in Docker If you're using a DXP trial license that's expiring or you have a new license (activation key) you must install, you can replace your container's existing license. Here's...
Upgrading to a New Docker Image
Official Documentation
Upgrading to a New Docker Image As new Liferay versions are released as Docker images, you can upgrade to them. Upgrading Liferay describes the process. Always back up your data and installation...
Installing Earlier Liferay Versions on JBoss EAP
Official Documentation
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 Tomcat
Official Documentation
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...
Setting Up JNDI on Tomcat
Official Documentation
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...
Configuring Externally Managed Services
Official Documentation
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...
AWS Managed Resources Reference
Official Documentation
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...
Configuring Internally Managed Services
Official Documentation
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
Official Documentation
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...
Self-Hosted Installation and Upgrades
Official Documentation
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
Official Documentation
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
Official Documentation
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 on Tomcat
Official Documentation
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...
Running Liferay for the First Time
Official Documentation
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...
Liferay Cloud Native Provisioning
Official Documentation
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...
Liferay Helm Values Reference
Official Documentation
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 DXP in Amazon Web Services
Official Documentation
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. ...