Liferay: Install and Setup Local DXP Instance on Windows

Man working at night coding and pointing on a screen with a pen
Reading Time: 3 minutes
Prerequisites
  • Liferay Basics- A rough idea about Liferay just to get started. If you’re a complete beginner please go through our Liferay Basics blog.
  • Java – Java JDK 8+ is mandatory and the JAVA_HOME path should be set.
Downloads

Please visit this link to download the Liferay DXP Bundle.

For this, you must have a Liferay account, if not please create one and log in using the account. Navigate again to the downloads page and fill in your details to start your trial. Please make sure to choose the bundle with Tomcat download option.

Liferay download

Now, start your download, you will also receive a license key in your email. It will be a link to download an XML file. If you don’t see the mail, please check our spam folder otherwise contact sales@liferay.com

Setup

In your Local Disk C:\ create a folder named liferay and under that create another folder “bundles”. Under this folder extract your Liferay 7z file. Please use third-party software like 7zip to extract as the windows default software might throw an error.

Liferay bundle path

After extracting, go into the liferay-dxp folder, and then go into the tomcat folder and under it the bin folder.

tomcat bin path

Here you will find a Windows Batch File named startup.bat, double-click to open it. This should open up a command line window. If not, please make sure you have JDK installed and the JAVA_HOME path set in environment variables.

This command line window will start up the Liferay Digital Experience Platform(DXP) and as soon as it is done, it will fire up your default browser. In your browser, you will see the Basic Configuration page.

Basic configuration page

In this page please provide the details that you will use for Portal and Admin user. Click on “Finish Configuration” when done.

Liferay Activation required page

At this point you will require the activation key that you received earlier. To set up your activation key, head back into the liferay-dxp folder and then into the deploy folder. Copy and paste your XML key into this folder. Your command line window running the liferay-dxp will recognise this key and register you with it. Now head back into your browser and just reload the page. You should be able to see the homepage now in your localhost:8080.

homepage

Here you can sign in as the admin user using the sign-in option present on the top-right corner of the homepage. The default password will be “test”, click on sign in. Agree to the Terms and Conditions placeholder. Now, on this page, you can change your password.

Next, you have the Password Reminder page. You can see your security question here and the answer will also be “test” here. Click on save and you will get the logged-in homepage with your admin user. Now you can click on the top left icon to open up the menu and customize your homepage.

admin user homepage
References

Liferay setup guide and documentation.

Conclusion

In this brief blog, we discussed how do we setup Liferay DXP on our Windows local machine. For more blogs on Liferay and many other new and emerging technologies please visit Knoldus Blogs.

Written by 

Agnibhas Chattopadhyay is a Software Consultant at Knoldus Inc. He is very passionate about Technology and Basketball. Experienced in languages like C, C++, Java, Python and frameworks like Spring/Springboot, Apache Kafka and CI/CD tools like Jenkins, Docker. He loves sharing knowledge by writing easy to understand tech blogs.