Packaging and deploying Spring Boot applications as WAR files
Tags: java, spring, tomcat, jetty
Published: 2021-09-02 14:27:39

This guide explains how to:

* Package a Maven-based [Spring Boot](https://spring.io/projects/spring-boot) application as a WAR file
* Deploy a WAR file to [Apache Tomcat](http://tomcat.apache.org/)
* Deploy a WAR file to [Eclipse Jetty](https://www.eclipse.org/jetty/)

Packaging a Maven-based Spring Boot application as a WAR file
-------------------------------------------------------------

To change the packaging in a [Maven](/learn/tutorials/learning-maven-concepts)-based Spring Boot application that was generated using the [Spring Initializr](https://start.spring.io/) or [Vaadin Start](https://start.vaadin.com/) tools, make the following changes in the pom.xml file:

1\. Modify the `<packaging>` element as follows:

    <packaging>war</packaging>

2\. If you plan to deploy to a different server than Apache Tomcat:

a) Add the Servlet API dependency to the project. Make sure to use the version that matches your project. For example, in the case of [Vaadin](/) applications:

    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <scope>provided</scope>
    </dependency>

b) Exclude the `spring-boot-starter-tomcat` dependency from the `spring-boot-starter-web dependency` if you are using [Spring MVC](https://docs.spring.io/spring-framework/docs/current/reference/html/web.html), or the `vaadin-spring-boot-starter` dependency if you are using [Vaadin](/). For example:  

    <dependency>
        <groupId>com.vaadin</groupId>
        <artifactId>vaadin-spring-boot-starter</artifactId>
        <exclusions>
            ...
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

3\. Optional: If you want to simplify the name of the WAR file and always build a file with the same name without version numbers, add the following to the `<build>` section:

    <finalName>${project.artifactId}</finalName>

4\. Build and package the application by running the `mvn package` command. If you are using Vaadin, enable the production profile (`mvn package -P production`). You can find the WAR file in the **target/** directory inside the Maven project.

Deploying a WAR file to Apache Tomcat
-------------------------------------

To deploy the application configured in the previous section to a local instance of Apache Tomcat:

1.  Download Apache Tomcat from the [project website](http://tomcat.apache.org/). Make sure to download the [correct version](http://tomcat.apache.org/whichversion.html), depending on the Java and Servlet API versions that your application uses. For example, in the case of Vaadin applications, [download Apache Tomcat version 9](https://tomcat.apache.org/download-90.cgi).
2.  Extract the downloaded file.
3.  Start the server by running the **start.sh** or **start.bat** scripts that you can find in the **bin/** directory inside the Apache Tomcat installation directory. You might have to add execute permissions to the script files in the **bin/** directory. For example, in Unix-like operating systems, run `chmod +x bin/*.sh`.
4.  Copy the WAR file from the **target/** directory inside your Maven project to the **webapps/** directory inside the Apache Tomcat installation directory.
5.  The application should be deployed automatically and made available at [http://localhost:8080/your-war-file-name](http://localhost:8080/your-war-file-name). Use ROOT.war if you want to deploy to the context root ([http://localhost:8080/](http://localhost:8080/)).

Deploying a WAR file to Eclipse Jetty
-------------------------------------

To deploy the application previously configured to a local instance of Eclipse Jetty:

1.  Download Eclipse Jetty from the [project website](https://www.eclipse.org/jetty/). Make sure to download the correct version, depending on the Java and Servlet API versions that your application uses. For example, in the case of Vaadin applications, download Eclipse Jetty 9.
2.  Extract the downloaded file.
3.  If you downloaded Eclipse Jetty 10, configure the server by running `java -jar start.jar --add-module=server,http,deploy` inside the Eclipse Jetty installation directory.
4.  Start the server by running **start.sh** start in the **bin/** directory inside the Eclipse Jetty installation directory. You might have to add execute permissions to the script files in the **bin/** directory by running `chmod +x bin/*.sh`.
5.  Copy the WAR file from the **target/** directory inside your Maven project to the **webapps/** directory inside the Eclipse Jetty installation directory.
6.  The application should be deployed automatically and made available at [http://localhost:8080/your-war-file-name](http://localhost:8080/your-war-file-name). Use root.war if you want to deploy to the context root ([http://localhost:8080/](http://localhost:8080/)).