diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/profiles.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/profiles.adoc index a414c93093..55ee0caa3a 100644 --- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/profiles.adoc +++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/profiles.adoc @@ -24,6 +24,16 @@ For example, you could include it in your `application.properties`, as shown in You could also specify it on the command line by using the following switch: `--spring.profiles.active=dev,hsqldb`. +If no profile is active, a default profile is enabled. +The name of the default profile is `default` and it can be tuned using the configprop:spring.profiles.default[] `Environment` property, as shown in the following example: + +[source,yaml,indent=0,subs="verbatim",configprops,configblocks] +---- + spring: + profiles: + default: "none" +---- + [[features.profiles.adding-active-profiles]] diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/properties-and-configuration.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/properties-and-configuration.adoc index bc98458ef5..19667ddbb2 100644 --- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/properties-and-configuration.adoc +++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/properties-and-configuration.adoc @@ -239,6 +239,24 @@ See "`<>`" in the "`Spring Boot features`" section f +[[howto.properties-and-configuration.set-default-spring-profile-name]] +=== Set the Default Profile Name +The default profile is a profile that is enabled if no profile is active. +By default, the name of the default profile is `default`, but it could be changed using a System property (configprop:spring.profiles.default[]) or an OS environment variable (configprop:spring.profiles.default[format=envvar]). + +In Spring Boot, you can also set the default profile name in `application.properties`, as shown in the following example: + +[source,yaml,indent=0,subs="verbatim",configprops,configblocks] +---- + spring: + profiles: + default: "dev" +---- + +See "`<>`" in the "`Spring Boot features`" section for more information. + + + [[howto.properties-and-configuration.change-configuration-depending-on-the-environment]] === Change Configuration Depending on the Environment Spring Boot supports multi-document YAML and Properties files (see <> for details) which can be activated conditionally based on the active profiles.