This version is still in development and is not considered stable yet. For the latest stable version, please use Spring Boot 3.3.5!

Getting Started

To get started with the plugin it needs to be applied to your project.

The plugin is published to the Spring snapshots repository. Gradle can be configured to use the snapshots repository and the plugin can then be applied using the plugins block. To configure Gradle to use the snapshots repository, add the following to your settings.gradle (Groovy) or settings.gradle.kts (Kotlin):

Groovy
Kotlin

pluginManagement {
	repositories {
		maven { url 'https://repo.spring.io/milestone' }
		maven { url 'https://repo.spring.io/snapshot' }
		gradlePluginPortal()
	}
}

pluginManagement {
	repositories {
		maven { url = uri("https://repo.spring.io/milestone") }
		maven { url = uri("https://repo.spring.io/snapshot") }
		gradlePluginPortal()
	}
}

The plugin can then be applied using the plugins block:

Groovy
Kotlin

plugins {
	id 'org.springframework.boot' version '3.3.6-SNAPSHOT'
}

plugins {
	id("org.springframework.boot") version "3.3.6-SNAPSHOT"
}

Applied in isolation the plugin makes few changes to a project. Instead, the plugin detects when certain other plugins are applied and reacts accordingly. For example, when the java plugin is applied a task for building an executable jar is automatically configured. A typical Spring Boot project will apply the groovy, java, or org.jetbrains.kotlin.jvm plugin as a minimum and also use the io.spring.dependency-management plugin or Gradle’s native bom support for dependency management. For example:

Groovy
Kotlin

plugins {
	id 'java'
	id 'org.springframework.boot' version '3.3.6-SNAPSHOT'
}

apply plugin: 'io.spring.dependency-management'

plugins {
	java
	id("org.springframework.boot") version "3.3.6-SNAPSHOT"
}

apply(plugin = "io.spring.dependency-management")

To learn more about how the Spring Boot plugin behaves when other plugins are applied please see the section on reacting to other plugins.