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
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....
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...
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...
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...
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...
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...
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...
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 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...
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...
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...
Installing Earlier Liferay Versions on WebSphere
Official Documentation
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 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...
Installing on JBoss EAP
Official Documentation
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...
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...
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 a Liferay-Tomcat Bundle
Official Documentation
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...
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 Liferay on an Application Server
Official Documentation
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 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...
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 on WildFly
Official Documentation
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,...
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...
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...
Using GovCloud to run Liferay in AWS
Official Documentation
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...
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...
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...
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...
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...
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...
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....
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...
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....
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...
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...
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...
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...
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. ...
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)...
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...
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...
Reference
Official Documentation
Reference When installing Liferay, you must take into consideration the specifics of your environment. These topics help you integrate Liferay into your existing environment and aid in...
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...
Liferay Helm Values Reference
Official Documentation
Liferay Helm Values Reference Helm is configured in YAML. Below are descriptions of the Liferay default Helm chart values. affinity: {} # Set Liferay DXP StatefulSet spec...
Making Liferay Public in AWS
Official Documentation
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...
Upgrading Liferay
Official Documentation
Upgrading Liferay Liferay is continuously being enhanced with new features as new versions are released. To access these features in your current project, you must upgrade your Liferay instance to...
Troubleshooting Upgrades
Official Documentation
Troubleshooting Upgrades Liferay has many out-of-the-box tools and features to identify and solve issues that may arise when performing an upgrade. To troubleshoot, you can upgrade modules...
Post-Upgrade Considerations
Official Documentation
Post-Upgrade Considerations After upgrading the database, you should configure Liferay for production again and check up on feature changes that might affect your Liferay instance. Re-enable...
Migrating the Database
Official Documentation
Migrating the Database For support, maintenance, or performance reasons, you may decide to migrate from the database you use to one of the other databases Liferay supports. Though the exact steps...
Updating Customizations
Official Documentation
Updating Customizations Plugins (e.g., themes, apps, and customizations) you've developed must be adapted to the new Liferay version. This can be as simple as updating dependencies or involve...