Liferay DXP
This liferay-portal repository contains the source code for Liferay DXP, Liferay's Java-based digital experience platform. Liferay Portal and Liferay DXP are now a single product. Building this repository produces a Liferay DXP bundle. The platform is maintained by Liferay engineering and a global community of contributors.
Getting Liferay DXP
Run Liferay DXP in any of these ways:
Build from source (this repository): Get the latest unreleased fixes, customize the platform, or contribute changes upstream. Build instructions are below.
Liferay DXP Free Tier: The fastest way to run Liferay DXP. Register for a Free Tier license and download a ready-to-run bundle. Recommended for evaluation and most nonproduction use. Includes clustering up to three nodes.
Liferay DXP Enterprise Subscription: Adds enterprise features (multifactor authentication, SAML, advanced analytics, production-scale clustering), certified releases, and Liferay Support. Contact sales.
If you previously ran Liferay Portal CE, the recommended upgrade path is Liferay DXP Free Tier. You can also build Liferay DXP from this repository.
Building Liferay DXP from Source
Prerequisites
Install these tools before building:
- JDK 17 (or JDK 21)
- Apache Ant 1.10.14 or higher
- Git
- Liferay Blade CLI (only needed if you plan to build client extensions or OSGi modules)
The build uses the included Gradle wrapper, so you do not need to install Gradle separately.
Build Steps
Create a working directory and
cdinto it. You clone two repositories side by side here:mkdir liferay-dev cd liferay-dev(Recommended) Clone
liferay-binaries-cache-2020to speed up builds. Without it, the build downloads dependencies on demand.git clone https://github.com/liferay/liferay-binaries-cache-2020 --branch master --single-branch --depth 1Fork
liferay/liferay-portalon GitHub, then clone your fork next toliferay-binaries-cache-2020:git clone https://github.com/<your-github-user>/liferay-portal cd liferay-portalAdd the upstream repository so you can fetch changes from
liferay/liferay-portal:git remote add upstream https://github.com/liferay/liferay-portalBuild the bundle:
ant allThe bundle is unpacked into
../bundlesand contains a Tomcat application server with Liferay DXP deployed.Start the bundle:
../bundles/tomcat-<version>/bin/startup.shThen visit
http://localhost:8080.
For more details, including IDE setup, deploying core changes, deploying modules, and submitting pull requests, see Building Liferay DXP from Source on Liferay Learn.
Modules
Liferay DXP includes hundreds of OSGi modules under modules. The build system, marker files, and Gradle conventions used by these modules are documented in modules/README.md.
Contributing
Contributions are welcome. See CONTRIBUTING.md to get started.
License
SPDX-License-Identifier: (LGPL-2.1-or-later OR LicenseRef-Liferay-DXP-EULA-2.0.0-2023-06)
See LICENSING.md for details.