How can I map multiple contexts to the same war file in Tomcat?

This can be done in several ways. I think this way is the most straightforward:

  1. Move the WAR file outside of the webapps/ auto-deploy directory
  2. Extract META-INF/context.xml from your WAR file. If your WAR doesn’t have a META-INF/context.xml file, just use a file with nothing but <Context /> in it
  3. Copy this file into Tomcat’s conf/[service]/[host]/ directory as both app1.xml and app2.xml. (The [service] is usually “Catalina” and the [host] is whatever the name of your virtual host is: on a default Tomcat configuration, the hostname is always “localhost”).
  4. Edit both app1.xml and app2.xml and set the docBase attribute for the <Context> element to point to the WAR file you moved in step #1
  5. Re-start Tomcat

This ought to give you a single physical WAR file and multiple contexts deployed from it.

Although Tomcat supports this configuration, I recommend against it: disk space is cheap, it changes nothing at runtime (you still get two copies of everything in memory), and you lose the flexibility of deploying different WAR files to different contexts and/or updating them separately without modifying the configuration of both contexts.

If you want my advice, stick to duplicate WAR files.

Leave a Comment