Shadowgraph
About
Sign in

paketo-buildpacks/maven

A Cloud Native Buildpack that builds Maven-based applications from source

36

stars

677

commits

Go

primary language

Sep 10, 2026

updated

build-system
cnb
jvm-applications
maven
Browse cluster: Cloud Native Buildpacks & JVM →

README

Paketo Buildpack for Maven

Buildpack ID: paketo-buildpacks/maven

Registry URLs: docker.io/paketobuildpacks/maven

The Paketo Buildpack for Maven is a Cloud Native Buildpack that builds Maven-based applications from source.

Behavior

This buildpack will participate if all the following conditions are met:

  • Another buildpack requires maven, jvm-application-package or both
  • <APPLICATION_ROOT>/pom.xml exists or BP_MAVEN_POM_FILE is set to an existing POM file.

The buildpack will do the following:

  • Requests that a JDK be installed
  • Links the ~/.m2 to a layer for caching
  • If <APPLICATION_ROOT>/mvnw does not exist and mvn is not on $PATH
    • Contributes Maven or Maven Daemon to a layer with all commands on $PATH
    • Runs <MAVEN_ROOT>/bin/mvn -Dmaven.test.skip=true --no-transfer-progress package to build the application
    • Caches $BP_MAVEN_BUILT_ARTIFACT to a layer
  • If <APPLICATION_ROOT>/mvnw exists
    • Runs <APPLICATION_ROOT>/mvnw -Dmaven.test.skip=true --no-transfer-progress package to build the application
    • Caches $BP_MAVEN_BUILT_ARTIFACT to a layer
  • If mvn is on $PATH
    • Runs mvn -Dmaven.test.skip=true --no-transfer-progress package to build the application
    • Caches $BP_MAVEN_BUILT_ARTIFACT to a layer
  • Removes the source code in <APPLICATION_ROOT>, following include/exclude rules
  • If $BP_MAVEN_BUILT_ARTIFACT matched a single file
    • Restores $BP_MAVEN_BUILT_ARTIFACT from the layer, expands the single file to <APPLICATION_ROOT>
  • If $BP_MAVEN_BUILT_ARTIFACT matched a directory or multiple files
    • Restores the files matched by $BP_MAVEN_BUILT_ARTIFACT to <APPLICATION_ROOT>
  • If $BP_JAVA_INSTALL_NODE is set to true and the buildpack finds one of the following at <APPLICATION_ROOT> or at the path set by $BP_NODE_PROJECT_PATH:
    • a yarn.lock file, the buildpack requests that yarn and node are installed at build time
    • a package.json file, the buildpack requests that node is installed at build time

Configuration

Environment VariableDescription
$BP_MAVEN_VERSIONConfigure the major Maven version (e.g. 3, 4). Since the buildpack only ships a single version of each supported line, updates to the buildpack can change the exact version of Maven installed. If you require a specific minor/patch version of Maven, use the Maven wrapper instead.
$BP_MAVEN_BUILD_ARGUMENTSConfigure the arguments to pass to Maven. Defaults to -Dmaven.test.skip=true --no-transfer-progress package. --batch-mode will be prepended to the argument list in environments without a TTY.
$BP_MAVEN_ADDITIONAL_BUILD_ARGUMENTSConfigure the additionnal arguments (e.g. -DskipJavadoc; appended to BP_MAVEN_BUILD_ARGUMENTS) to pass to Maven. Defaults to `` (empty string).
$BP_MAVEN_ACTIVE_PROFILESConfigure the active profiles (comma separated: e.g. p1,!p2,?p3) to pass to Maven. Defaults to `` (empty string).
$BP_MAVEN_BUILT_MODULEConfigure the module to find application artifact in. Defaults to the root module (empty).
$BP_MAVEN_BUILT_ARTIFACTConfigure the built application artifact explicitly. Supersedes $BP_MAVEN_BUILT_MODULE Defaults to target/*.[ejw]ar. Can match a single file, multiple files or a directory. Can be one or more space separated patterns.
$BP_MAVEN_POM_FILESpecifies a custom location to the project's pom.xml file. It should be a full path to the file under the /workspace directory or it should be relative to the root of the project (i.e. /workspace'). Defaults to pom.xml`.
$BP_MAVEN_DAEMON_ENABLEDTriggers apache maven-mvnd to be installed and configured for use instead of Maven. The default value is false. Set to true to use the Maven Daemon.
$BP_MAVEN_SETTINGS_PATHSpecifies a custom location to Maven's settings.xml file. If $BP_MAVEN_SETTINGS_PATH is set and a Maven binding is provided, the binding takes the higher precedence.
$BP_INCLUDE_FILESColon separated list of glob patterns to match source files. Any matched file will be retained in the final image. Defaults to `` (i.e. nothing).
$BP_EXCLUDE_FILESColon separated list of glob patterns to match source files. Any matched file will be specifically removed from the final image. If include patterns are also specified, then they are applied first and exclude patterns can be used to further reduce the fileset.
$BP_JAVA_INSTALL_NODEConfigure whether to request that yarn and node are installed by another buildpack**. If set to true, the buildpack will check the app root or path set by $BP_NODE_PROJECT_PATH for either: A yarn.lock file, which requires that yarn and node are installed or, a package.json file, which requires that node is installed. Defaults to false
$BP_NODE_PROJECT_PATHConfigure a project subdirectory to look for package.json and yarn.lock files

Note

** If the node and/or yarn requirements are met and the Node Engine or Yarn participate in the build, environment variables related to these buildpacks can be set, such as BP_NODE_PROJECT_PATH or BP_NODE_VERSION. See the Paketo Node.js docs for more info.

Bindings

The buildpack optionally accepts the following bindings:

Type: maven

SecretDescription
settings.xmlIf present --settings=<path/to/settings.xml> is prepended to the maven arguments
settings-security.xmlIf present -Dsettings.security=<path/to/settings-security.xml> is prepended to the maven arguments

Type: dependency-mapping

KeyValueDescription
<dependency-digest><uri>If needed, the buildpack will fetch the dependency with digest <dependency-digest> from <uri>

License

This buildpack is released under version 2.0 of the Apache License.

Contributors

paketo-bot

235 commits

dmikusa

215 commits

dependabot[bot]

66 commits

nebhale

63 commits

Similar repos

paketo-buildpacks/gradle

A Cloud Native Buildpack that builds Gradle-based applications from source

34

shared topics

paketo-buildpacks/spring-boot

A Cloud Native Buildpack that contributes Spring Boot dependency information and slices an…

205

shared topics

paketo-buildpacks/java

A Cloud Native Buildpack with an order definition suitable for Java applications

150

shared topics

paketo-buildpacks/native-image

A Cloud Native Buildpack that creates native images from Java applications

58

shared topics

paketo-buildpacks/spring-boot-native-image

A Cloud Native Buildpack that creates native images from Java applications

58

shared topics

paketo-buildpacks/graalvm

A Cloud Native Buildpack that provides the GraalVM implementations of JREs and JDKs

39

shared topics

paketo-buildpacks/bellsoft-liberica

A Cloud Native Buildpack that provides the Bellsoft Liberica implementations of JREs and JDKs

95

shared topics

paketo-buildpacks/java-native-image

A Cloud Native Buildpack with an order definition suitable for Java native image applications

35

shared contributors

Languages

Go

98.5%

Shell

1.5%

paketo-buildpacks/maven

A Cloud Native Buildpack that builds Maven-based applications from source

36

stars

677

commits

Go

primary language

Sep 10, 2026

updated

build-system
cnb
jvm-applications
maven
Browse cluster: Cloud Native Buildpacks & JVM →

README

Paketo Buildpack for Maven

Buildpack ID: paketo-buildpacks/maven

Registry URLs: docker.io/paketobuildpacks/maven

The Paketo Buildpack for Maven is a Cloud Native Buildpack that builds Maven-based applications from source.

Behavior

This buildpack will participate if all the following conditions are met:

  • Another buildpack requires maven, jvm-application-package or both
  • <APPLICATION_ROOT>/pom.xml exists or BP_MAVEN_POM_FILE is set to an existing POM file.

The buildpack will do the following:

  • Requests that a JDK be installed
  • Links the ~/.m2 to a layer for caching
  • If <APPLICATION_ROOT>/mvnw does not exist and mvn is not on $PATH
    • Contributes Maven or Maven Daemon to a layer with all commands on $PATH
    • Runs <MAVEN_ROOT>/bin/mvn -Dmaven.test.skip=true --no-transfer-progress package to build the application
    • Caches $BP_MAVEN_BUILT_ARTIFACT to a layer
  • If <APPLICATION_ROOT>/mvnw exists
    • Runs <APPLICATION_ROOT>/mvnw -Dmaven.test.skip=true --no-transfer-progress package to build the application
    • Caches $BP_MAVEN_BUILT_ARTIFACT to a layer
  • If mvn is on $PATH
    • Runs mvn -Dmaven.test.skip=true --no-transfer-progress package to build the application
    • Caches $BP_MAVEN_BUILT_ARTIFACT to a layer
  • Removes the source code in <APPLICATION_ROOT>, following include/exclude rules
  • If $BP_MAVEN_BUILT_ARTIFACT matched a single file
    • Restores $BP_MAVEN_BUILT_ARTIFACT from the layer, expands the single file to <APPLICATION_ROOT>
  • If $BP_MAVEN_BUILT_ARTIFACT matched a directory or multiple files
    • Restores the files matched by $BP_MAVEN_BUILT_ARTIFACT to <APPLICATION_ROOT>
  • If $BP_JAVA_INSTALL_NODE is set to true and the buildpack finds one of the following at <APPLICATION_ROOT> or at the path set by $BP_NODE_PROJECT_PATH:
    • a yarn.lock file, the buildpack requests that yarn and node are installed at build time
    • a package.json file, the buildpack requests that node is installed at build time

Configuration

Environment VariableDescription
$BP_MAVEN_VERSIONConfigure the major Maven version (e.g. 3, 4). Since the buildpack only ships a single version of each supported line, updates to the buildpack can change the exact version of Maven installed. If you require a specific minor/patch version of Maven, use the Maven wrapper instead.
$BP_MAVEN_BUILD_ARGUMENTSConfigure the arguments to pass to Maven. Defaults to -Dmaven.test.skip=true --no-transfer-progress package. --batch-mode will be prepended to the argument list in environments without a TTY.
$BP_MAVEN_ADDITIONAL_BUILD_ARGUMENTSConfigure the additionnal arguments (e.g. -DskipJavadoc; appended to BP_MAVEN_BUILD_ARGUMENTS) to pass to Maven. Defaults to `` (empty string).
$BP_MAVEN_ACTIVE_PROFILESConfigure the active profiles (comma separated: e.g. p1,!p2,?p3) to pass to Maven. Defaults to `` (empty string).
$BP_MAVEN_BUILT_MODULEConfigure the module to find application artifact in. Defaults to the root module (empty).
$BP_MAVEN_BUILT_ARTIFACTConfigure the built application artifact explicitly. Supersedes $BP_MAVEN_BUILT_MODULE Defaults to target/*.[ejw]ar. Can match a single file, multiple files or a directory. Can be one or more space separated patterns.
$BP_MAVEN_POM_FILESpecifies a custom location to the project's pom.xml file. It should be a full path to the file under the /workspace directory or it should be relative to the root of the project (i.e. /workspace'). Defaults to pom.xml`.
$BP_MAVEN_DAEMON_ENABLEDTriggers apache maven-mvnd to be installed and configured for use instead of Maven. The default value is false. Set to true to use the Maven Daemon.
$BP_MAVEN_SETTINGS_PATHSpecifies a custom location to Maven's settings.xml file. If $BP_MAVEN_SETTINGS_PATH is set and a Maven binding is provided, the binding takes the higher precedence.
$BP_INCLUDE_FILESColon separated list of glob patterns to match source files. Any matched file will be retained in the final image. Defaults to `` (i.e. nothing).
$BP_EXCLUDE_FILESColon separated list of glob patterns to match source files. Any matched file will be specifically removed from the final image. If include patterns are also specified, then they are applied first and exclude patterns can be used to further reduce the fileset.
$BP_JAVA_INSTALL_NODEConfigure whether to request that yarn and node are installed by another buildpack**. If set to true, the buildpack will check the app root or path set by $BP_NODE_PROJECT_PATH for either: A yarn.lock file, which requires that yarn and node are installed or, a package.json file, which requires that node is installed. Defaults to false
$BP_NODE_PROJECT_PATHConfigure a project subdirectory to look for package.json and yarn.lock files

Note

** If the node and/or yarn requirements are met and the Node Engine or Yarn participate in the build, environment variables related to these buildpacks can be set, such as BP_NODE_PROJECT_PATH or BP_NODE_VERSION. See the Paketo Node.js docs for more info.

Bindings

The buildpack optionally accepts the following bindings:

Type: maven

SecretDescription
settings.xmlIf present --settings=<path/to/settings.xml> is prepended to the maven arguments
settings-security.xmlIf present -Dsettings.security=<path/to/settings-security.xml> is prepended to the maven arguments

Type: dependency-mapping

KeyValueDescription
<dependency-digest><uri>If needed, the buildpack will fetch the dependency with digest <dependency-digest> from <uri>

License

This buildpack is released under version 2.0 of the Apache License.

Similar repos

paketo-buildpacks/gradle

A Cloud Native Buildpack that builds Gradle-based applications from source

34

shared topics

paketo-buildpacks/spring-boot

A Cloud Native Buildpack that contributes Spring Boot dependency information and slices an…

205

shared topics

paketo-buildpacks/java

A Cloud Native Buildpack with an order definition suitable for Java applications

150

shared topics

paketo-buildpacks/native-image

A Cloud Native Buildpack that creates native images from Java applications

58

shared topics

paketo-buildpacks/spring-boot-native-image

A Cloud Native Buildpack that creates native images from Java applications

58

shared topics

paketo-buildpacks/graalvm

A Cloud Native Buildpack that provides the GraalVM implementations of JREs and JDKs

39

shared topics

paketo-buildpacks/bellsoft-liberica

A Cloud Native Buildpack that provides the Bellsoft Liberica implementations of JREs and JDKs

95

shared topics

paketo-buildpacks/java-native-image

A Cloud Native Buildpack with an order definition suitable for Java native image applications

35

shared contributors

Contributors

paketo-bot

235 commits

dmikusa

215 commits

dependabot[bot]

66 commits

nebhale

63 commits

Languages

Go

98.5%

Shell

1.5%