Java HTML Groovy JavaScript XSLT Shell Other
Failed to load latest commit information.
.github Merge branch '1.3.x' Jul 20, 2016
.mvn Upgrade to Maven 3.3.9 Apr 13, 2016
eclipse Introduce spring-boot-autoconfigure-processor Jan 24, 2017
spring-boot-actuator-docs Replace and remove deprecated API usage Jan 24, 2017
spring-boot-actuator Correct HAL Browser location to reflect version of web jar Feb 22, 2017
spring-boot-autoconfigure Merge branch '1.5.x' Feb 22, 2017
spring-boot-cli Rename EmbeddedServletContainer -> EmbeddedWebServer Feb 6, 2017
spring-boot-dependencies Add dependency management for Commons Lang3 Feb 22, 2017
spring-boot-deployment-tests Merge branch '1.5.x' Feb 22, 2017
spring-boot-devtools Separate container customization from ServerProperties Feb 8, 2017
spring-boot-docs Merge branch '1.5.x' Feb 20, 2017
spring-boot-full-build Merge branch '1.5.x' Jan 26, 2017
spring-boot-integration-tests Merge branch '1.5.x' Feb 16, 2017
spring-boot-parent Polish merge Feb 8, 2017
spring-boot-samples Merge branch '1.5.x' Feb 20, 2017
spring-boot-starters Update exclusions to reflect change in Hibernate's JPA API dependency Feb 22, 2017
spring-boot-test-autoconfigure Add explicit dependency on Gson Feb 22, 2017
spring-boot-test Fix forward merge of new SpyBean test to use correct Mockito 2 API Feb 21, 2017
spring-boot-tools Merge branch '1.5.x' Feb 16, 2017
spring-boot Merge branch '1.5.x' Feb 16, 2017
.gitignore Refine ApplicationHome detection logic Jun 10, 2016
.settings-template.xml Merge branch '1.5.x' Nov 22, 2016
.travis.yml Speed up Travis build Oct 24, 2016
CODE_OF_CONDUCT.adoc Add contributor covenant Jan 29, 2016
CONTRIBUTING.adoc Merge branch '1.3.x' Jul 20, 2016
LICENSE.txt Update license details Nov 19, 2014
README.adoc Fix escaping Sep 6, 2016
mvnw Add Maven wrapper Oct 26, 2015
mvnw.cmd Add Maven wrapper Oct 26, 2015
pom.xml Merge branch '1.5.x' Jan 26, 2017


Spring Boot Build Status Chat

Spring Boot makes it easy to create Spring-powered, production-grade applications and services with absolute minimum fuss. It takes an opinionated view of the Spring platform so that new and existing users can quickly get to the bits they need.

You can use Spring Boot to create stand-alone Java applications that can be started using java -jar or more traditional WAR deployments. We also provide a command line tool that runs spring scripts.

Our primary goals are:

  • Provide a radically faster and widely accessible getting started experience for all Spring development

  • Be opinionated out of the box, but get out of the way quickly as requirements start to diverge from the defaults

  • Provide a range of non-functional features that are common to large classes of projects (e.g. embedded servers, security, metrics, health checks, externalized configuration)

  • Absolutely no code generation and no requirement for XML configuration

Installation and Getting Started

The reference documentation includes detailed installation instructions as well as a comprehensive getting started guide. Documentation is published in HTML, PDF and EPUB formats.

Here is a quick teaser of a complete Spring Boot application in Java:

import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.web.bind.annotation.*;

public class Example {

	String home() {
		return "Hello World!";

	public static void main(String[] args) throws Exception {, args);


Getting help

Having trouble with Spring Boot? We’d like to help!

Reporting Issues

Spring Boot uses GitHub’s integrated issue tracking system to record bugs and feature requests. If you want to raise an issue, please follow the recommendations below:

  • Before you log a bug, please search the issue tracker to see if someone has already reported the problem.

  • If the issue doesn’t already exist, create a new issue.

  • Please provide as much information as possible with the issue report, we like to know the version of Spring Boot that you are using, as well as your Operating System and JVM version.

  • If you need to paste code, or include a stack trace use Markdown ``` escapes before and after your text.

  • If possible try to create a test-case or project that replicates the issue. You can submit sample projects as pull-requests against the spring-boot-issues GitHub project. Use the issue number for the name of your project.

Building from Source

You don’t need to build from source to use Spring Boot (binaries in, but if you want to try out the latest and greatest, Spring Boot can be easily built with the maven wrapper. You also need JDK 1.8 (although Boot applications can run on Java 1.6).

$ ./mvnw clean install

If you want to build with the regular mvn command, you will need Maven v3.2.1 or above.

You may need to increase the amount of memory available to Maven by setting a MAVEN_OPTS environment variable with the value -Xmx512m. Remember to set the corresponding property in your IDE as well if you are building and running tests there (e.g. in Eclipse go to Preferences→Java→Installed JREs and edit the JRE definition so that all processes are launched with those arguments). This property is automatically set if you use the maven wrapper.

Also see CONTRIBUTING.adoc if you wish to submit pull requests, and in particular please fill out the Contributor’s Agreement before your first change, however trivial. (Or if you filed such an agreement already for another project just mention that in your pull request.)

Building reference documentation

The reference documentation requires the documentation of the Maven plugin to be available so you need to build that first since it’s not generated by default.

$ ./mvnw clean install -pl spring-boot-tools/spring-boot-maven-plugin -Pdefault,full

The documentation also includes auto-generated information about the starters. To allow this information to be collected, the starter projects must be built first:

$ ./mvnw clean install -f spring-boot-starters

Once this is done, you can build the reference documentation with the command below:

$ ./mvnw clean prepare-package -pl spring-boot-docs -Pdefault,full
The generated documentation is available from spring-boot-docs/target/contents/reference


There are a number of modules in Spring Boot, here is a quick overview:


The main library providing features that support the other parts of Spring Boot, these include:

  • The SpringApplication class, providing static convenience methods that make it easy to write a stand-alone Spring Application. Its sole job is to create and refresh an appropriate Spring ApplicationContext

  • Embedded web applications with a choice of container (Tomcat or Jetty for now)

  • First class externalized configuration support

  • Convenience ApplicationContext initializers, including support for sensible logging defaults


Spring Boot can configure large parts of common applications based on the content of their classpath. A single @EnableAutoConfiguration annotation triggers auto-configuration of the Spring context.

Auto-configuration attempts to deduce which beans a user might need. For example, If HSQLDB is on the classpath, and the user has not configured any database connections, then they probably want an in-memory database to be defined. Auto-configuration will always back away as the user starts to define their own beans.


Starters are a set of convenient dependency descriptors that you can include in your application. You get a one-stop-shop for all the Spring and related technology that you need without having to hunt through sample code and copy paste loads of dependency descriptors. For example, if you want to get started using Spring and JPA for database access just include the spring-boot-starter-data-jpa dependency in your project, and you are good to go.


The Spring command line application compiles and runs Groovy source, making it super easy to write the absolute minimum of code to get an application running. Spring CLI can also watch files, automatically recompiling and restarting when they change.


Spring Boot Actuator provides additional auto-configuration to decorate your application with features that make it instantly deployable and supportable in production. For instance if you are writing a JSON web service then it will provide a server, security, logging, externalized configuration, management endpoints, an audit abstraction, and more. If you want to switch off the built in features, or extend or replace them, it makes that really easy as well.


Spring Boot Loader provides the secret sauce that allows you to build a single jar file that can be launched using java -jar. Generally you will not need to use spring-boot-loader directly, but instead work with the Gradle or Maven plugin.


Groovy samples for use with the command line application are available in spring-boot-cli/samples. To run the CLI samples type spring run <sample>.groovy from samples directory.

Java samples are available in spring-boot-samples and should be built with maven and run by invoking java -jar target/<sample>.jar.


The site contains several guides that show how to use Spring Boot step-by-step:


Spring Boot is Open Source software released under the Apache 2.0 license.