Le site francophone consacré au projet Eclipse et à OSGi




Sysdeo Eclipse Tomcat Launcher plugin



Plugin features

  • Starting and stopping Tomcat 4.x, 5.x, 6.x, 7.x

  • Registering Tomcat process to Eclipse debugger

  • Creating a WAR project (wizard can update server.xml file)

  • Adding Java Projects to Tomcat classpath

  • Setting Tomcat JVM parameters, classpath and bootclasspath

  • Exporting a Tomcat project to a WAR File

  • Capability to use a custom Tomcat classloader to load classes in several java projects at the same classloader level than classes in a Tomcat project, see readmeDevLoader.html (Thanks Martin Kahr)


Support and contributions

Contact plugintomcat@eclipsetotale.com



This plugin is free and open-source

Warning : installing plugins on Windows 7 can fail without error message, see this article for more information and workarounds : 'Eclipse Plugin Installation and Windows User Access Control'

Version File Date Comment


21 June 2014

Works with Eclipse 4.4


20 January 2011

Works with Eclipse 3.1 to 4.3
Add Tomcat 7 support


10 May 2007

Works with Eclipse 3.1, 3.2, 3.3, 3.4, 3.5 and 3.6
Fix a problem with HTTPS

For a better Maven support have a look to this page


13 April 2007

Works with Eclipse 3.1, 3.2 and 3.3M6
Tomcat 6 support added

3.2 beta3

20 November 2006

Works with Eclipse 3.2 and Eclipse 3.1
Tomcat 6 support added

3.2 beta2

25 October 2006

Works with Eclipse 3.2 and Eclipse 3.1
Tomcat 6 support added


15 September 2005

Works with Eclipse 3.0 and Eclipse 3.1 (fix a problem with Eclipse 3.1M6)


27 July 2004

Works with Eclipse 3.0 and Eclipse 2.1


1er August 2003

Works with Eclipse 2.1 and Eclipse 3.0 M2

Tomcat 4.x patch for JSP debugging (Thanks to Johan Compagner)

Tomcat Version File Date


1 April 2003

To install this patch, unzip the file in <%TOMCAT_HOME%>/classes for tomcat 4.0x, or in <%TOMCAT_HOME%>/common/classes for Tomcat 4.1.x



  • This plugin does not contain Tomcat.
    (Download and install Tomcat before using this plugin).
    This is a design choice not to include Tomcat in the plugin distribution, this way the same plugin version can works with any Tomcat version.

  • Download tomcatPluginVxxx.zip

  • Unzip it in :
    - Eclipse_Home/dropins for Eclipse 3.4, 3.5 and 3.6
    - Eclipse_Home/plugins for Eclipse 2.1, 3.0, 3.1, 3.2 and 3.3

  • Plugin activation for Eclipse 3.x :
    - launch eclipse once using this option : -clean
    - if Tomcat icons are not shown in toolbar : select menu 'Window>Customize Perspective...>Commands', and check 'Tomcat' in 'Available command groups'

  • Set Tomcat version and Tomcat home : Workbench -> Preferences, select Tomcat and set Tomcat version and Tomcat home (Tomcat version and Tomcat home are the only required fields, other settings are there for advanced configuration).

  • This plugin launches Tomcat using the default JRE checked in Eclipe preferences window.
    To set a JDK as default JRE for Eclipse open the preference window : Window -> Preferences -> Java -> Installed JREs.
    This JRE must be a JDK (This is a Tomcat prerequisite).

  • The plugin sets itself Tomcat classpath and bootclasspath. Use Preferences -> Tomcat ->JVM Settings, only if you need specific settings.


Documentation and tutorials

Official documation (french) : http://www.eclipsetotale.com/articles/tomcat/tomcatPluginDocFR.html

Tutorials (english) :



  • Installing plugins on Windows 7 can fail without warning, see this article for more information and workarounds : 'Eclipse Plugin Installation and Windows User Access Control'

  • In some case, despite it is correctly unzipped in Eclipse 3 'plugins' directory, the plugin is not loaded : run Eclipse with the -clean option to solve the problem.

  • ClassNotFound when using DevLoader and launching Tomcat 5.5.12 and above
    Workaround : set context definition mode (Preferences->Tomcat) to 'Context files'.
    Explanations :
    This problem is due to a change in Tomcat 5.5.12 and above (see http://issues.apache.org/bugzilla/show_bug.cgi?id=37302 ,
    We hope this bug will be fix but it seems that Tomcat developers don't care about it because it happens when a context containing its own loader is defined in server.xml file and since Tomcat 5 defining context in server.xml is not recommended)

  • ClassNotFoundException on javac/Main when accessing JSP : Tomcat is started with a JRE instead of a JDK.

  • If you have a problem with the plugin check eclipse log file (<%Your_Workspace_dir%>/.metadata/.log)


If you have any problem with this plugin send an email to plugintomcat@eclipsetotale.com .
(Select this button : Preferences->Tomcat->JVM Settings->Dump configuration to .log file, and include in your email the corresponding lines of your .log file, it is in <%Your_Workspace_dir%>/.metadata)







(c) EclipseTotale - contact(arobase)eclipsetotale.com