Baeldung Pro comes with both absolutely No-Ads as well as finally with Dark Mode, for a clean learning experience:
Once the early-adopter seats are all used, the price will go up and stay at $33/year.
Enable or Disable Embedded Tomcat with Profile in Spring Boot
Last updated: April 16, 2025
Azure Container Apps is a fully managed serverless container service that enables you to build and deploy modern, cloud-native Java applications and microservices at scale. It offers a simplified developer experience while providing the flexibility and portability of containers.
Of course, Azure Container Apps has really solid support for our ecosystem, from a number of build options, managed Java components, native metrics, dynamic logger, and quite a bit more.
To learn more about Java features on Azure Container Apps, visit the documentation page.
You can also ask questions and leave feedback on the Azure Container Apps GitHub page.
Azure Container Apps is a fully managed serverless container service that enables you to build and deploy modern, cloud-native Java applications and microservices at scale. It offers a simplified developer experience while providing the flexibility and portability of containers.
Of course, Azure Container Apps has really solid support for our ecosystem, from a number of build options, managed Java components, native metrics, dynamic logger, and quite a bit more.
To learn more about Java features on Azure Container Apps, you can get started over on the documentation page.
And, you can also ask questions and leave feedback on the Azure Container Apps GitHub page.
Modern software architecture is often broken. Slow delivery leads to missed opportunities, innovation is stalled due to architectural complexities, and engineering resources are exceedingly expensive.
Orkes is the leading workflow orchestration platform built to enable teams to transform the way they develop, connect, and deploy applications, microservices, AI agents, and more.
With Orkes Conductor managed through Orkes Cloud, developers can focus on building mission critical applications without worrying about infrastructure maintenance to meet goals and, simply put, taking new products live faster and reducing total cost of ownership.
Try a 14-Day Free Trial of Orkes Conductor today.
Modern software architecture is often broken. Slow delivery leads to missed opportunities, innovation is stalled due to architectural complexities, and engineering resources are exceedingly expensive.
Orkes is the leading workflow orchestration platform built to enable teams to transform the way they develop, connect, and deploy applications, microservices, AI agents, and more.
With Orkes Conductor managed through Orkes Cloud, developers can focus on building mission critical applications without worrying about infrastructure maintenance to meet goals and, simply put, taking new products live faster and reducing total cost of ownership.
Try a 14-Day Free Trial of Orkes Conductor today.
Mocking is an essential part of unit testing, and the Mockito library makes it easy to write clean and intuitive unit tests for your Java code.
Get started with mocking and improve your application tests using our Mockito guide:
Handling concurrency in an application can be a tricky process with many potential pitfalls. A solid grasp of the fundamentals will go a long way to help minimize these issues.
Get started with understanding multi-threaded applications with our Java Concurrency guide:
Spring 5 added support for reactive programming with the Spring WebFlux module, which has been improved upon ever since. Get started with the Reactor project basics and reactive programming in Spring Boot:
Since its introduction in Java 8, the Stream API has become a staple of Java development. The basic operations like iterating, filtering, mapping sequences of elements are deceptively simple to use.
But these can also be overused and fall into some common pitfalls.
To get a better understanding on how Streams work and how to combine them with other language features, check out our guide to Java Streams:
Explore Spring Boot 3 and Spring 6 in-depth through building a full REST API with the framework:
Yes, Spring Security can be complex, from the more advanced functionality within the Core to the deep OAuth support in the framework.
I built the security material as two full courses - Core and OAuth, to get practical with these more complex scenarios. We explore when and how to use each feature and code through it on the backing project.
You can explore the course here:
All Access is finally out, with all of my Spring courses. Learn JUnit is out as well, and Learn Maven is coming fast. And, of course, quite a bit more affordable. Finally.
>> GET THE COURSE
Spring Data JPA is a great way to handle the complexity of JPA with the powerful simplicity of Spring Boot.
Get started with Spring Data JPA through the guided reference course:
End-to-end testing is a very useful method to make sure that your application works as intended. This highlights issues in the overall functionality of the software, that the unit and integration test stages may miss.
Playwright is an easy-to-use, but powerful tool that automates end-to-end testing, and supports all modern browsers and platforms.
When coupled with LambdaTest (an AI-powered cloud-based test execution platform) it can be further scaled to run the Playwright scripts in parallel across 3000+ browser and device combinations:
Yes, we're now running our Spring Sale. All Courses are 25% off until 26th May, 2025:
Yes, we're now running our Spring Sale. All Courses are 25% off until 26th May, 2025:
1. Overview
When we want to enable or disable the embedded Tomcat server in a Spring Boot application, we need to consider different approaches based on our application’s requirements. By default, Spring Boot provides an embedded Tomcat server, but in some cases, we might want to disable it.
For applications that require an embedded server, we can use the default configuration. However, for applications that do not expose web endpoints or need to run as background services, disabling Tomcat can optimize resource usage.
In this tutorial, we’ll explore when to enable or disable the embedded Tomcat server and how to configure Spring Boot profiles to achieve this dynamically.
2. Understanding Embedded Tomcat in Spring Boot
Spring Boot simplifies application deployment by bundling an embedded Tomcat server within the application’s executable JAR file. This approach eliminates the need to install and configure an external Tomcat instance, making development and deployment more efficient for us.
Spring Boot uses Spring Boot Starters to include the necessary dependencies for embedded Tomcat. The default starter, spring-boot-starter-web, automatically configures and initializes Tomcat when present in the classpath.
2.1. Advantages of Embedded Tomcat
Spring Boot’s embedded Tomcat server offers several benefits:
- Simplified deployment: No need to install an external Tomcat server
- Self-contained applications: The application can be packaged as a JAR file and run anywhere
- Automatic configuration: Spring Boot configures Tomcat automatically based on dependencies
- Flexibility: Can be easily replaced with other embedded servers like Jetty or Undertow
2.2. When to Disable Tomcat Server
While embedded Tomcat is useful, there are cases where disabling it is beneficial to us:
- Non-web applications: Applications that don’t serve HTTP requests, such as CLI tools or batch jobs
- Microservices with alternative servers:Â Some services may use a dedicated web server like Nginx
- Resource optimization: Disabling Tomcat reduces memory and CPU usage
3. Configuring Spring Boot Profiles
Spring Boot provides us with the spring.profiles.active property to define environment-specific configurations. We can create different profile-based configurations to control whether our embedded Tomcat server is enabled or not.
To define profiles, we typically create separate configuration files such as:
- application-dev.properties (for development with Tomcat enabled)
- application-batch.properties (for batch processing without Tomcat)
4. Disabling Embedded Tomcat with Profiles
Spring Boot determines whether to enable an embedded web server based on the spring.main.web-application-type property. We can set it to NONE to disable the embedded Tomcat.
To do this in a profile-specific configuration, we modify the application-batch.properties file:
spring.main.web-application-type=NONEWhen this profile is active, Spring Boot will not start Tomcat, treating the application as a non-web service.
Alternatively, we can configure this setting using YAML:
spring:
main:
web-application-type: NONE
5. Example Configuration for Different Profiles
Let’s configure an application with two profiles:
- Development Profile (dev) – Tomcat enabled (default setting).
- Batch Profile (batch) – Tomcat disabled.
To ensure that our embedded Tomcat server starts normally, let’s set the property in our application-dev.properties file:
spring.main.web-application-type=SERVLETTo disable our embedded Tomcat server for batch processing, let’s set the property in our application-batch.properties file:
spring.main.web-application-type=NONE
6. Switching Between Profiles
Once we’ve defined multiple profile configurations, we can activate the desired profile via the application.properties file:
spring.profiles.active=batch
Alternatively, we can pass it as a command-line argument:
java -Dspring.profiles.active=batch -jar myapp.jarThis flexibility allows us to switch between web-enabled and non-web modes as needed during development, testing, or production deployment.
7. Conclusion
Spring Boot allows flexible configuration of the embedded Tomcat server using profiles. By leveraging spring.main.web-application-type, we can disable Tomcat when needed for non-web applications, optimizing resource usage and deployment configurations. Using profile-based settings or dynamic Java logic ensures that our application adapts to different environments seamlessly.
