Spring Boot – Deploy WAR file to Tomcat

In this article, we will show you how to create a Spring Boot traditional WAR file and deploy to a Tomcat servlet container.

In Spring Boot, to create a WAR for deployment, we need 3 steps:

  1. Extends SpringBootServletInitializer
  2. Marked the embedded servlet container as provided.
  3. Update packaging to war

Tested with

  • Spring Boot 2.1.2.RELEASE
  • Tomcat 8 and 9
  • Maven 3
Note
In Spring Boot, the new final executable JAR file with embedded server solution may not suitable in all production environments, especially the deployment team (a team with good knowledge of server optimization and monitoring skills, but lack of, the development experience), they want full control of the server, and they don’t touch code, so, we need a traditional WAR file.

1. Extends SpringBootServletInitializer

Update the @SpringBootApplication class to extend SpringBootServletInitializer, and override the configure method.

1.1 Classic Spring Boot JAR deployment.

StartWebApplication.java

import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class StartWebApplication {

    public static void main(String[] args) throws Exception {
        SpringApplication.run(StartWebApplication.class, args);
    }

}

1.2 For WAR deployment.

StartWebApplication.java

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

@SpringBootApplication
public class StartWebApplication extends SpringBootServletInitializer {

    public static void main(String[] args) {
        SpringApplication.run(StartWebApplication.class, args);
    }

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(StartWebApplication.class);
    }
}


/*@SpringBootApplication
public class StartWebApplication {

    public static void main(String[] args) throws Exception {
        SpringApplication.run(StartWebApplication.class, args);
    }

}*/

For multiple main classes, make sure tell Spring Boot which main class to start :

pom.xml

  <properties>
      <!-- The main class to start by executing java -jar -->
      <start-class>com.mkyong.SpringBootWebApplication</start-class>
  </properties>
  

Read this – Spring Boot – Which main class to start

2. Marked the embedded servlet container as provided

pom.xml

<dependencies>

	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-thymeleaf</artifactId>
	</dependency>

	<!-- marked the embedded servlet container as provided -->
	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-tomcat</artifactId>
		<scope>provided</scope>
	</dependency>

</dependencies>

3. Update packaging to war

pom.xml

  <packaging>war</packaging>

Done, build the project and copy the WAR file for deployment.

Download Source Code

$ git clone https://github.com/mkyong/spring-boot.git
$ cd web-thymeleaf-war
$ mvn package
$ copy web-thymeleaf-war/target/mkyong.war $TOMCAT/webapps/
$ start Tomcat
$ localhost:8080/mkyong

References

About the Author

author image
mkyong
Founder of Mkyong.com, love Java and open source stuff. Follow him on Twitter, or befriend him on Facebook or Google Plus. If you like my tutorials, consider make a donation to these charities.

Comments

avatar
20 Comment threads
6 Thread replies
5 Followers
 
Most reacted comment
Hottest comment thread
24 Comment authors
vRadheTedWangDidoKhamphai Recent comment authors
newest oldest most voted
Mohammed Qurashi
Guest
Mohammed Qurashi

Awesome tutorial, I had it working for my spring-boot app on tomcat 8

Adolf Mrls
Guest
Adolf Mrls

Hi Mkyong, great tutorial
in the case to need a “upload-dir” where?
(i put it in the root and dont work x( ) Help pls!

vRadhe
Guest
vRadhe

It is not running from main class or not execute which contains main method

Ted
Guest
Ted

To get it working with Java 9+ you need to add this to your pom file (xml bind removed in Java 9+):

javax.xml.bind
jaxb-api
2.3.0

Wang
Guest
Wang

Hi Mkyong, I followed your example and got the following error from Tomcat log. 01-Oct-2018 14:29:57.442 INFO [http-nio-8080-exec-43] org.apache.jasper.servlet.TldScanner.scanJars At least one JAR was scanned for TLDs yet contained no TLDs. Enable debug logging for this logger for a complete list of JARs that were scanned but no TLDs were found in them. Skipping unneeded JARs during scanning can improve startup time and JSP compilation time. 01-Oct-2018 14:30:11.851 SEVERE [http-nio-8080-exec-43] org.apache.catalina.core.StandardContext.startInternal One or more listeners failed to start. Full details will be found in the appropriate container log file 01-Oct-2018 14:30:11.852 SEVERE [http-nio-8080-exec-43] org.apache.catalina.core.StandardContext.startInternal Context [/nuhs] startup failed due to… Read more »

Khamphai
Guest
Khamphai

how to deploy spring boot war file to glassfish4.1 server ?

Joel Rives
Guest
Joel Rives

I find the tutorial very simple and straight forward. I downloaded the code, built it and deployed to Tomcat. It works. I am now trying to apply this to my project with no luck yet. Here is the pertinent part of my project hierarchy: config SpringBootWebApplication controller HelloController The SpringBootWebApplication is exactly as in your tutorial The HelloController is my version of your WelcomeController. I looks like this: @Controller public class HelloController { @RequestMapping(“/”) public String index() { return “Greetings from Spring Boot!”; } } This does not work. The war deploys just fine but attempts to access it fail.… Read more »

Carol
Guest
Carol

Thank you!

nonsaprei
Guest
nonsaprei

I just wanted to add that specifying a server.contextPath in the application.properties is pointless, because Tomcat won’t let you use that.

ronald haring
Guest
ronald haring

only works on servlet3+ containers i think, tomcat 7 does nothing

Gabriel Andrade
Guest
Gabriel Andrade

Im using spring boot with JSF and i am able to start the server just fine, but after a while(around 1 or 2 days), the server stops and cant startup again, giving me the error:
2018-02-18 10:30:08.018 INFO 7052 — [localhost-startStop-2] ationConfigEmbeddedWebApplicationContext : Closing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@2e601386: startup date [Thu Feb 15 13:20:57 UTC 2018]; root of context hierarchy
2018-02-18 10:30:08.033 INFO 7052 — [localhost-startStop-2] o.s.j.e.a.AnnotationMBeanExporter : Unregistering JMX-exposed beans on shutdown

Chhorn Elit
Guest
Chhorn Elit

I build your war to deploy, but cannot. Then I realize the pom.xml specify java 8.0. However, tomcat server were running on java 7.0. Thanks though.

Anthony
Guest
Anthony

Thanks for the tutorial!
Is there a more seamless way to continue deployment to the application. (In case I made a small change to a template for example). I would have to re-upload the whole war file to tomcat.

Rohit Basu
Guest
Rohit Basu

I tried my own and i post the issue in
https://stackoverflow.com/questions/47294386/issues-in-spring-boot-war-file-deployment-in-tomcat-server
I am getting error:
“Whitelabel Error Page

This application has no explicit mapping for /error, so you are seeing this as a fallback.

Thu Nov 16 18:03:35 IST 2017
There was an unexpected error (type=Not Found, status=404).
No message available”

Please check if you can help.

Cuong Bui Quang
Guest
Cuong Bui Quang

I follow your tutorial and my spring boot application runs twice when I deploy war to tomcat. I also solve this by remove Spring Boot Application from extending SpringBootServletInitializer, my Spring Boot version is 1.5.7.RELEASE

Shahid Akhtar
Guest
Shahid Akhtar

Hi Mkyong,
Would you please let me know how to set contextPath for spring boot application if deployed as a war on
standalone tomcat?

Regards,
Shahid Akhtar.

Pavithra
Guest
Pavithra

This tutor is very simple!! Thanks

phuctran
Guest
phuctran

to run your example, need to add “server.error.whitelabel.enabled=false” to application.properity

webdev
Guest
webdev

how to run this application

Amit
Guest
Amit

hi Mkyong,
I installed your example.
It seems server.contextPath is not recognized by external tomcat8.

Do you have any suggestions on how to set context path of a spring boot(1.5) application in external tomcat8?

Regards
Amit

Hetarth Shah
Guest
Hetarth Shah
Shahid Akhtar
Guest
Shahid Akhtar

Hi Shah,
Given link states about contextPath change will work for embedded tomcat. It does not work for
standalone containers. Would you please let me know how contextPath can be set for standalone
containers?

Thanks
Shahid Akhtar

Mohammed Amen
Guest
Mohammed Amen

By the way why do you need to deploy anything in stand alone container? You dont you use the embedded one …it is quite easy to use with very less work to do. If you are using eclipse as ide you can add tomcat maven compiler plugin in pom.xml along with the spring-boot-starter-tomcat. It is a perfect combination u only need to run the SpringBootWebApplication java class and then maven clean and install which will automatically add the war to the tomcat without unnecessary overhead and u can then load the page.

Shahid Akhtar
Guest
Shahid Akhtar

it does not work for standalone container

Salil Kumar
Guest
Salil Kumar

Hi Amit ,

To run this application , you need to add the below in application.properties.
server.port=8080
server.error.whitelabel.enabled=false.

Then run the below command :

C:……….> mvn spring-boot:run

Then open any browser and run :

http://localhost:8080/mkyong/

Dido
Guest
Dido

Every request I make returns 401. I use JWT authentication. Anyone with the same problem?