Site Search - Liferay Learn

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,...

Migrating Liferay Instances

Official Documentation

Migrating Liferay Instances Liferay DXP 2025.Q2+/Portal GA148+ [Beta Feature](../../security-and-administration/administration/configuring-liferay/feature-flags.md#beta-feature-flags) You can...

Provisioning Liferay in Kubernetes

Official Documentation

Provisioning Liferay in Kubernetes Cloud environments require a layer of orchestration to manage containers, and that is usually Kubernetes. If you're already heavily invested in the cloud, you can...

Installing Liferay in Amazon Web Services

Official Documentation

Installing Liferay in Amazon Web Services You can run Liferay DXP on AWS using a new or an existing EKS cluster; a plain installation or Liferay's offering on AWS Marketplace. Either installation...

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 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 Wildfly

Official Documentation

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 Earlier Liferay Versions on Application Servers

Official Documentation

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 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...

Installing Earlier Liferay Versions on WebLogic

Official Documentation

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...

Running Liferay DXP in Amazon Web Services

Official Documentation

Running Liferay DXP in Amazon Web Services There are two ways to host Liferay DXP in AWS: Installing Liferay DXP from AWS Marketplace. Installing Liferay DXP using the plain Helm chart. For...

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...

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...

Auto-Scaling in AWS

Official Documentation

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...

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: : ...

Viewing Metrics from Kubernetes

Official Documentation

Viewing Metrics from Kubernetes It is important to track resource usage in the Kubernetes cluster. To view your resource usage, you must use a collector and an exporter. Before you can view...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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....

Maintaining a Liferay Installation

Official Documentation

Maintaining a Liferay Installation Starting with Liferay DXP 7.3 SP3+ and 7.4 GA1+, Liferay adopted a new release model for delivering updates and fixes. This new approach is referred to as Bundle...

Backing Up

Official Documentation

Backing Up Once you have your DXP installation running, you should implement a comprehensive backup plan that accounts for unforeseen events. Backup copies are also valuable for testing updates...

Maintaining Clustered Installations

Official Documentation

Maintaining Clustered Installations Setting up your Liferay DXP installation to function in a cluster provides performance and scalability improvements, but also requires additional consideration...

Blue-Green Deployments

Official Documentation

Blue-Green Deployments Blue-green is a deployment technique in which you duplicate your production environment (the blue environment) and modify the duplicate (the green environment) with software...

Performing Rolling Restarts

Official Documentation

Performing Rolling Restarts The rolling restart cluster maintenance process involves shutting down and updating nodes one at a time (while the other nodes are running) until they're all updated....

Applying a Hotfix

Official Documentation

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...

Patching Liferay

Official Documentation

Patching Liferay Liferay DXP uses Bundle Releases for its latest releases. Please see Updating Liferay if you are applying an Update. All Hotfixes are patches. If you're applying a Hotfix,...

Advanced Patching for DXP 7.2

Official Documentation

Advanced Patching for DXP 7.2 Here are the DXP 7.2 advanced patching topics: Using Slim Bundles demonstrates conserving disk space by using DXP fix pack bundles that don't include Patch Files. ...

Custom Code and Patch Compatibility

Official Documentation

Custom Code and Patch Compatibility Subscribers If you deploy code that customizes or patches your DXP 7.2 installation, you must maintain its compatibility with all patches you're using. The...

Slimming Down Patched Installations

Official Documentation

Slimming Down Patched Installations Subscribers In Liferay DXP 7.2, patch information is retained in Patch Files in the installation by default. This facilitates restoring DXP to a previous patch...

Using Slim Bundles

Official Documentation

Using Slim Bundles Subscribers Liferay DXP 7.2 Fix Packs and Service Packs are also released bundled with the Tomcat application server. They are available as traditional bundles and Slim Bundles....

Installing Patches in Earlier Versions

Official Documentation

Installing Patches in Earlier Versions Subscribers The Patching Tool applies Fix Packs (including Security Fix Packs and Service Packs) for versions prior to Liferay DXP 7.3 SP3. It also applies...

Configuring the Patching Tool

Official Documentation

Configuring the Patching Tool Subscribers The Patching Tool can be adapted to any DXP installation. The tool's auto-discovery option is the easiest way to configure the Patching Tool. If you...

Getting Patch Information

Official Documentation

Getting Patch Information Subscribers You can see patch information at a glance, which helps maintain your installation and get help from Liferay Support. The Patching Tool's info command lists...

Updating Liferay

Official Documentation

Updating Liferay Liferay DXP 7.3 SP3+/Portal 7.4 GA1+ Update your Liferay installation with Bundle Releases. The latest features, security releases, as well as library updates are all delivered...

Accessing DXP Patch Code

Official Documentation

Accessing DXP Patch Code Subscribers Liferay DXP Fix Pack and Hotfix source code is available in a private GitHub repository called liferay-dxp. The source code facilitates identifying and...

Installing the Patching Tool

Official Documentation

Installing the Patching Tool Subscribers The Patching Tool is easy to install and update. Installation Download the Patching Tool from the Customer Portal. For DXP 7.3+, download the latest...

Uninstalling Patches

Official Documentation

Uninstalling Patches Subscribers After you install a patch, you may decide to restore your installation to a previous patch level. Here you'll learn how to Uninstall Patches Revert (uninstall)...

Updating Previous Versions of Liferay

Official Documentation

Updating Previous Versions of Liferay Staying current with updates gives you the best security and quality. Security Updates are releases that address the latest security issues immediately. ...

JVM Configuration

Official Documentation

JVM Configuration As of Liferay DXP 2024.Q3+/Portal GA125+, Liferay DXP/Portal requires a Java JDK 17 or 21 (prior versions support JDKs 8 and 11) with specific JVM option settings. There are also...

Activating Liferay DXP

Official Documentation

Activating Liferay DXP Subscription Required Liferay DXP is activated using an XML (.xml) activation key. It specifies your DXP subscription terms or trial agreement. When you run Liferay DXP for...

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...

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,...

Self-Hosted Installation and Upgrades

Official Documentation

Self-Hosted Installation and Upgrades

Search Results