Configuration

If no explicit configuration is provided then the Tomcat plugin defaults to the following:

  • Tomcat manager URL of http://localhost:8080/manager
  • Authentication details of username admin and no password
  • Context path of /${project.build.finalName}

These can be overridden as described below.

Using a different Tomcat manager URL

To configure the plugin for a different Tomcat instance, add a plugin configuration block to your pom.xml as follows:

<plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>tomcat-maven-plugin</artifactId>
        <configuration>
                <url>http://www.mydomain.com:1234/mymanager</url>
        </configuration>
</plugin>

The default Tomcat manager URL is http://localhost:8080/manager.

Using different Tomcat manager authentication details

To specify a different username and password to use when authenticating with Tomcat manager:

  1. Add a plugin configuration block to your pom.xml:
    <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>tomcat-maven-plugin</artifactId>
            <configuration>
                    <server>myserver</server>
            </configuration>
    </plugin>
    
  2. Add a corresponding server block to your settings.xml:
    <server>
            <id>myserver</id>
            <username>myusername</username>
            <password>mypassword</password>
    </server>
    

The default authentication details are username admin and no password.

Using a different context path

The default context path is /${project.build.finalName}, which itself defaults to /${artifactId}-${version}.

The preferred way of changing the context path is to change the finalName by adding the following to your pom.xml:

<build>
        <finalName>mycontext</finalName>
</build>

Alternatively, a different context path can be specified by adding an explicit plugin configuration block to your pom.xml as follows:

<plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>tomcat-maven-plugin</artifactId>
        <configuration>
                <path>/mycontext</path>
        </configuration>
</plugin>