A Step-by-Step Guide to Disabling the Mail Health Check in Spring Boot

Published on 2023.11.27


In Spring Boot, the Actuator module provides a range of endpoints for monitoring the health of your application. One of these endpoints is the mail health check, which verifies if the application's email sending functionality is working correctly. However, in some cases, you may want to disable this health check to prevent unnecessary errors or delays. This article will guide you through the process of disabling the mail health check in Spring Boot.

Step 1: Add Actuator Dependency

To start, make sure that the Actuator module is included as a dependency in your Spring Boot project's pom.xml or build.gradle file:


Step 2: Configure Health Check Properties

Next, you need to configure the health check properties in your application.properties or application.yml file. Specifically, you need to set the following property to false:


Step 3: Verify the Change

After making the necessary configuration changes, restart your Spring Boot application. You can now check the Actuator endpoints to confirm that the mail health check is disabled. Open the following URL in your browser:


You should see a JSON response that includes the status of various health indicators, but the mail health check should not be included.


Disabling the mail health check in Spring Boot can help prevent unnecessary errors or delays in your application. By following the steps outlined in this guide, you can easily disable this health check and customize the monitoring functionality of your Spring Boot application.