Liferay is a Gartner Magic Quadrant Leader for the Sixth Year! Find out why

Installing 6.0 WAR on Tomcat 6

IMPORTANT: For official instructions on how to deploy Liferay on any of the supported applications servers visit wiki page just records specific instructions of a community member.

This only applies to Windows. At the time of writing this wiki, the author used Tomcat 6.0.26


I'm going to assume that you know how to install Tomcat. If not, you'll need to reference the documents on the Apache Tomcat website for assistance with that step, as it is outside the scope of this document.

Make sure your Tomcat installation starts and runs before continuing.


Install the Liferay Dependencies bundle in your Tomcat installation first. Do this by copying the files from the Dependencies .zip into the $TOMCAT_HOME/lib/ext directory. If you do not have the ext directory, create one. It should be noted that Tomcat requires 2 extra files:

  • jta.jar (Available here; download class files and rename the ZIP file jta.jar.)
  • mail.jar (Available here; located in root of the downloaded ZIP file.)

Be sure to include those 2 files in the $tomcat/lib/ext directory in addition to the Liferay Dependencies.

Deploying the WAR file#

1) Delete all files under TOMCAT_HOME\webapps\ROOT, then copy all of the files from the Liferay WAR to that directory.

2) Move the files from the .war to the now empty ROOT folder. The simplest way to do this is to open it with an archiver program such as 7zip or WinRAR, then copy/extract all of the files into ROOT.

3) Add the code

set "JAVA_OPTS=%JAVA_OPTS% -Xmx1024m -XX:MaxPermSize=256m"

in the startup.bat file located in the $TOMCAT_HOME/bin directory. This line of code will prevent Java memory issues.

Finally, to startup Tomcat, execute "startup.bat"


0 Attachments
Average (0 Votes)
The average rating is 0.0 stars out of 5.
Threaded Replies Author Date
" copy all of the files from the Liferay WAR to... al forbes November 2, 2010 6:49 AM
where can I find the file liferay.war? Italo Ney Pessoa November 11, 2010 1:35 PM
you can build the liferay.war from source, see... Denis Vaumoron November 26, 2010 6:03 AM
I download the "" file... Jameson Hill April 14, 2011 6:45 PM
I've been trying to install the unbundled... Jameson Hill April 16, 2011 4:47 PM
I am trying to integrate liferay 5.1.1 with... nikhil kshirsagar May 3, 2011 6:21 AM
what about new portlets? I really hate Liferay!... zahra zarei October 31, 2011 7:13 AM
I was able to install version 6.1 beta 4 on... Jeff Okuhara November 30, 2011 4:52 PM
Jeff, Can you elaborate on this? Where did... Ryan T January 21, 2012 12:54 PM

" copy all of the files from the Liferay WAR to that directory."
Ok where is this file located? I search the entire liferay-portal-6.0.5 folder and there is no Liferay.war file or folder for that matter.
Posted on 11/2/10 6:49 AM.
where can I find the file liferay.war?
Posted on 11/11/10 1:35 PM.
you can build the liferay.war from source, see :
Posted on 11/26/10 6:03 AM in reply to Italo Ney Pessoa.
I download the "" file from When I extract all of the files to ROOT, it always results in a "SEVERE: Error listenerStart" error. Any ideas as to why this is happening?
Posted on 4/14/11 6:45 PM.
I've been trying to install the unbundled version of Liferay to an existing Tomcat 6 installation without success. I've followed these instructions closely, but to no avail; always ending up with a "SEVERE: Error listenerStart" error on server start-up, as Tomcat attempts to deploy the Liferay application.
Posted on 4/16/11 4:47 PM.
I am trying to integrate liferay 5.1.1 with tomcat 6.0.26 and I followed the steps at

Liferay comes up and I can login as , but I don't see any of the administration pages (in guest/private pages) that I use for setting organization-> authentication ->opensso settings. Any idea why these pages are not seen at all ?
Posted on 5/3/11 6:21 AM.
what about new portlets? I really hate Liferay!
It seems that liferay can't register them, when I deploy them it says:
Deployment will start in a few seconds.

and then nothing....
I google it and it seems it's a univeral problem!
don't you want to solve that?????
Posted on 10/31/11 7:13 AM.
I was able to install version 6.1 beta 4 on latest Tomcat 7.0.23 using the instuctions above as is and gettign around the "SEVERE: Error listenerStart" adding and additional .jar called persistence.jar and modifying the file in the <apache home>\conf directory
look for... common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/l­ib,${catalina.home}/lib/*.jar

and add append ,${catalina.home}/lib/ext,${catalina.home}/lib/ext/*.jar to the end of it and result is..

Posted on 11/30/11 4:52 PM.

Can you elaborate on this? Where did you get the persistence.jar file from?

I am having this issue with LR 6.0.6 and Tomcat 6
Posted on 1/21/12 12:54 PM in reply to Jeff Okuhara.