Submit Feedback
Legacy Knowledge Base
Published Sep. 10, 2025

How to set up a clean bundle in your local environment

Written By

Bae Helene

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

Issue

  • What is a clean bundle?

  • What are the steps to build a clean bundle in a local environment?

Environment

  • Liferay DXP 7.0
  • Liferay DXP 7.1
  • Liferay DXP 7.2
  • Liferay DXP 7.3

Resolution

  • What is Clean Bundle?

    • It means "no customization is applied".

    • This means "an environment with only the minimum necessary settings applied" to reproduce and confirm the event.

  • advance preparation

    • Prepare a local environment (laptop or other machine) to set up
    • Get the bundle you want by selecting the product and type from the drop-down menu on thedownload pagein the Help Center
      • Please get theservice packin advance for your version.
      • You can also download a combination of Service Pack+Fix Pack.
    • Obtain a development license (activation key) fromActivation Key Issue Pagein Help Center

  • (call) setup procedure

    • Create a dedicated bundles directory for your Liferay instance in your local environment
      Configure the directory as follows
      • Windows: C:\liferay\bundles created
      • Unix/Linux: Create username/liferay/bundles .
    • Unzip the compressed service pack file (liferay-dxp-tomcat-[バージョン].tar.gz/7z) that you downloaded beforehand, and extract it directly under the following directory
      • Windows: C:\liferay\bundles
      • Unix/Linux: username/liferay/bundles
    • Copy the activation key (xml file)to the{LIFERAY_HOME}/ deploy
    • After moving to {TOMCAT_HOME}/bindirectory, start Tomcat with the following operation.
      • Windows: Double-click startup.bat .
      • Unix/Linux: On a terminal, run . /catalina.sh run on a terminal
    • The activation key will be automatically deployed
    • When the server startup is completed, the browser that accessed the URL "http://localhost:8080" will be launched
    • After completing the initial startup "Basic Settings" settings, perform the following initial settings.
      • I agree to the Terms of Use
      • Change your password
      • Set a question and answer in case you forget your password.
    • After the initial startup setup,{LIFERAY_HOME}directory will containportal-setup-wizard.properties . In the
    • This completes the setup.

  • Points to note when setting up

    • Please note that when setting up a clean bundle with a combination of service pack+fix packApply fix pack" is required

Additional Information

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?