Liferay7 development setup

Liferay 7 development setup

Liferay 7 development setup tutorial is to setup Liferay 7 development environment in local machine and access this tutorial to setup Liferay Eclipse IDE and tomcat in your local.

  • Liferay uses plugin sdk development environment and hold portlets,themes,layouts,ext,hooks and ANT Build scripts.
  • Liferay 7 uses OSGI platform that replaces traditional use of plugin-sdks with OSGI Modules, but still Liferay 7 supports Plugin SDK development.
  • Liferay 7 uses liferay-workspace to hold all modules,gradles, libraries,themes,wars,configs
  • portal-service.jar renamed to portal-kernel.jar, so liferay 6 code base  need to be update with new API change in Liferay7 migration process.

Liferay 7 Development Setup:

   Step1: Download Liferay and Java8

  • Click here to download Liferay7  tomcat community edition(liferay-ce-portal-tomcat-7.0-ga3) from sourceforge
  • Download Eclipse IDE :liferay-ide-eclipse-windows-x64-3.1.0-M1. I recommend to download liferay-ide-neon-m1 version as it is latest one.
  • Install Java8
  • MySQL version should be greater than  5.6
  • Extract the eclipse and it requires JDK8. update eclipse.inf file with -vm argument with JDK 8 bin path
    • --vm
      C:/Program Files/Java/jdk1.8.0_101/bin

      Step2: Create Liferay Workspace

      Liferay workspace need to create to hold all modules and make sure that you configured proper proxy settings in eclipse if you are behind firewall.  Go to windows-> preferences -> Network settings and select Manual. Update the with corp user name and password.

      liferay7 installation
      liferay7 setup

      In eclipse, click on  File-> New -> Liferay Workspace Project and provide workspace name. It will download all required libraries from gradle repository.

      liferay7 workspace creation
      liferay7 workspace

      Step3 : Liferay 7 workspace structure


      Step4 : Liferay 7 Tomcat Setup in Eclipse

      Now, we will configure tomcat in Liferay. Click on File->New-> Server; Select Liferay 7.x and  click on Next.  Update  the tomcat server  location with download tomcat and Lieray bundles directory with in liferay home(which you extracted  liferay-ce-portal-tomcat-7.0-ga3)


      liferay7 server configuration in eclipse
      liferay7 server configuration in eclipse


      Step5 : Liferay 7 Bundles auto configuration

      In Liferay 7 community edition, module auto deployment path need to configure and can done in two ways

  •  Liferay tomcat runtime:
    • Click on Liferay 7x
    • click on runtime
    • Update Liferay Portal bundle directory with liferay home directory as shown in belowliferay-7-auto-deployment
  • – open file in  liferay-workspace folder and add the below property
    •  liferay.workspace.home.dir=D:/programming/Lifera7Ce/liferay-ce-portal-7.0-ga3

      Step6: Liferay 7 Database configuration

  • Create database  in mysql : create database lportal7_ce character set utf8;
  • Create file and add below database properties and liferay home.
  • jdbc.default.url=jdbc\:mysql\://localhost:3307/lportal7_ce?useUnicode\=true&characterEncoding\=UTF-8&useFastDateParsing\=false

    Copy the mysql to tomcat\lib\ext if not is not exist and  start the server and you will get config page and complete the setupconfig

  • Liferay home page will open  and start developing portlet. liferayhome

Note:  Some times, you may the below exception, so the access the below tutorial to fix the issue:

org.gradle.tooling.BuildException: Could not fetch model of type ‘EclipseProject’ using Gradle distribution ‘’.

Liferay Gradle SSLHandshake or PKIX path building Issue

Liferay Gradle SSLHandshake or PKIX path building Issue While setting up Liferay DXP in local, you might get the below exception in creating workspace project for the first time. You will get the issue if JDK version is below Java…


7 thoughts on “Liferay7 development setup”
    1. You have to 2 things inorder to configure your liferay plugin sdk in liferay 7
      1)Upgrade your database to liferay 7 using liferay database upgrade client present in liferay 7 bundle.
      2)Upgrade your plugin sdk code using liferay-code-upgrade-tool present in liferay ide.

  1. Good job, I got it working thanks to this tutorial.

    Just want to add that the must be put in D:/programming/Lifera7Ce/liferay-ce-portal-7.0-ga3/tomcat-8.0.32/webapps/ROOT/WEB-INF/classes

    1. Thanks Montes. Placing portal-ext properties is depends on “liferay.home” property in

Leave a Reply

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