Setting Up Your First Liferay Workspace: A Beginner’s Guide

Liferay Version: 7.2, 7.3, 7.4

Welcome to the world of Liferay! If you’re just beginning your journey with the Liferay Digital Experience Platform (DXP), Liferay Workspace Setup is your first crucial step. This guide will walk you through installing and configuring a Liferay development environment in an easily understandable and practical way.

What is Liferay Workspace?

Liferay Workspace is a set of tools and an environment designed to streamline working with Liferay DXP. It helps manage the lifecycle of Liferay projects, from development to production.


Before starting, ensure you have:

  • Java JDK: Required for running Liferay DXP. Download and install Java JDK.
  • Node.js: Necessary for building Liferay themes and front-end tasks. Download Node.js.

Please check JDK Requirements for Different Versions of Liferay DXP

Step 1: Installing Liferay Workspace

  1. Download Liferay Workspace: Visit Liferay’s official site for the latest version of Liferay Workspace. Choose the version suitable for your OS.
  2. Unzip the File: Extract the files to your desired location. This directory is your ‘Liferay Workspace’.

Step 2: Setting Up Liferay DXP

  1. Navigate to Workspace: Open a terminal or command prompt and navigate to the Liferay Workspace directory.
  2. Initialize Liferay DXP: Run ./gradlew initBundle. This command downloads and initializes Liferay DXP with Tomcat as the default server.
  3. Wait for Completion: The process might take time due to downloading components.

Step 3: Starting Liferay DXP

  • Go to the bundles Folder: Inside the Liferay Workspace, find the ‘bundles’ folder where Liferay DXP resides.
  • Start Liferay DXP: Run ./ (Unix/Linux/Mac) or start.bat (Windows) in the ‘bundles’ folder.
  • Access Liferay DXP: Open a browser and go to http://localhost:8080. Follow the setup wizard.

Step 4: Exploring Liferay Workspace

  • Modules: Create OSGi modules including portlets, themes, and service builders here.
  • Themes: Develop themes for Liferay DXP.
  • Configs: Contains configuration files for different environments.

Step 5: Building Your First Project

  • Create a Project: In the terminal, run ./gradlew create -t mvc-portlet -d modules/my-first-portlet to create a sample MVC portlet.
  • Build and Deploy: Navigate to modules/my-first-portlet and run ../gradlew deploy.
  • View Your Portlet: Refresh your Liferay DXP page. Your new portlet should be under ‘Applications’ → ‘Sample’.


Congratulations on setting up your first Liferay Workspace and deploying a sample project! This is the beginning of your journey with Liferay DXP. Explore and build amazing digital experiences.

For any issues or questions, the Liferay community is a great resource for support and knowledge.

Happy Liferay Learning!

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Thanks !

Thanks for sharing this, you are awesome !