Built by Maven

Maven Configuration Options

These parameters don't configure plugins, but Maven itself. The parameters's list is also available as yaml file.

Key Type Description Default Value Since Source
maven.build.timestamp.format String Build timestamp format. yyyy-MM-dd'T'HH:mm:ssXXX 3.0.0 Model properties
maven.build.version String Maven build version: a human-readable string containing this Maven version, buildnumber, and time of its build. - 3.0.0 System properties
maven.builder.maxProblems Integer Max number of problems for each severity level retained by the model builder. 100 4.0.0 User properties
maven.consumer.pom Boolean User property for enabling/disabling the consumer POM feature. true 4.0.0 User properties
maven.consumer.pom.flatten Boolean User property for controlling consumer POM flattening behavior.
  • When set to true, consumer POMs are flattened by removing dependency management and keeping only direct dependencies with transitive scopes.
  • When set to false (default), consumer POMs preserve dependency management like parent POMs, allowing dependency management to be inherited by consumers.
 false 4.1.0 User properties
maven.consumer.pom.removeUnusedManagedDependencies Boolean User property for controlling removal of unused managed dependencies during consumer POM flattening.
  • When set to true (default), managed dependencies that do not appear in the resolved dependency tree are removed from the consumer POM to keep it lean. This is important when using BOMs like Spring Boot or Quarkus that contain hundreds of managed dependency entries.
  • When set to false, all managed dependencies are preserved in the consumer POM, which may be needed in rare cases where downstream consumers override transitive dependency versions and rely on the original managed dependencies for alignment.
 true 4.1.0 User properties
maven.consumer.pom.sanitizeRepositories Boolean User property for controlling whether the repositories published in a consumer POM are restricted to the repositories declared in the project's own POM file.
  • When set to true (default), repositories that are present in the effective model only because they were inherited from a (possibly remote) parent POM or injected by an active settings.xml profile are removed from the consumer POM before it is published. A warning is logged for every removed repository, and for every retained repository together with its URL.
  • When set to false, every non-central repository of the effective model is published in the consumer POM, restoring the previous behavior.
 true 4.1.0 User properties
maven.deploy.snapshot.buildNumber Integer User property for overriding calculated "build number" for snapshot deploys. Caution: this property should be RARELY used (if used at all). It may help in special cases like "aligning" a reactor build subprojects build numbers to perform a "snapshot lock down". Value given here must be maxRemoteBuildNumber + 1 or greater, otherwise build will fail. How the number to be obtained is left to user (ie by inspecting snapshot repository metadata or alike). Note: this feature is present in Maven 3.9.7 but with different key: maven.buildNumber. In Maven 4 as part of cleanup effort this key was renamed to properly reflect its purpose. - 4.0.0 User properties
maven.ext.class.path String Extensions class path. - User properties
maven.home String Maven home. - 3.0.0 System properties
maven.installation.conf String Maven installation configuration directory. ${maven.home}/conf 4.0.0 User properties
maven.installation.extensions String Maven installation extensions. ${maven.installation.conf}/extensions.xml 4.0.0 User properties
maven.installation.settings String Maven installation settings. ${maven.installation.conf}/settings.xml 4.0.0 User properties
maven.installation.toolchains String Maven installation toolchains. ${maven.installation.conf}/toolchains.xml 4.0.0 User properties
maven.logger.cacheOutputStream Boolean If the output target is set to "System.out" or "System.err" (see preceding entry), by default, logs will be output to the latest value referenced by System.out/err variables. By setting this parameter to true, the output stream will be cached, i.e. assigned once at initialization time and re-used independently of the current value referenced by System.out/err. false 4.0.0 User properties
maven.logger.dateTimeFormat String The date and time format to be used in the output messages. The pattern describing the date and time format is defined by SimpleDateFormat. If the format is not specified or is invalid, the number of milliseconds since start up will be output. - 4.0.0 User properties
maven.logger.defaultLogLevel String Default log level for all instances of SimpleLogger. Must be one of ("trace", "debug", "info", "warn", "error" or "off"). If not specified, defaults to "info". - 4.0.0 User properties
maven.logger.levelInBrackets Boolean Should the level string be output in brackets? Defaults to false. false 4.0.0 User properties
maven.logger.logFile String The output target which can be the path to a file, or the special values "System.out" and "System.err". Default is "System.err". - 4.0.0 User properties
maven.logger.showDateTime Boolean Set to true if you want the current date and time to be included in output messages. Default is false. false 4.0.0 User properties
maven.logger.showLogName Boolean Set to true if you want the Logger instance name to be included in output messages. Defaults to true. true 4.0.0 User properties
maven.logger.showShortLogName Boolean Set to true if you want the last component of the name to be included in output messages. Defaults to false. false 4.0.0 User properties
maven.logger.showThreadId Boolean If you would like to output the current thread id, then set to true. Defaults to false. false 4.0.0 User properties
maven.logger.showThreadName Boolean Set to true if you want to output the current thread name. Defaults to true. true 4.0.0 User properties
maven.logger.warnLevelString String The string value output for the warn level. Defaults to WARN. WARN 4.0.0 User properties
maven.maven3Personality Boolean User property for controlling "maven personality". If activated Maven will behave as previous major version, Maven 3. false 4.0.0 User properties
maven.model.dependencyInterpolation.full Boolean User property for opting back into the previous behavior of interpolating repository-resolved models (dependencies and parents) against the full set of session properties (system, environment and CLI).
  • When set to false (default), models resolved from a repository are interpolated only against their own <properties>, preventing property leaking from the requesting build into transitive POMs.
  • When set to true, full interpolation is applied as in previous Maven versions.
 false 4.1.0 User properties
maven.modelBuilder.interns String Comma-separated list of XML contexts/fields to intern during POM parsing for memory optimization. When not specified, a default set of commonly repeated contexts will be used. Example: "groupId,artifactId,version,scope,type" - 4.0.0 User properties
maven.modelBuilder.parallelism Integer ProjectBuilder parallelism. cores/2 + 1 4.0.0 User properties
maven.plugin.validation String Plugin validation level. inline 3.9.2 User properties
maven.plugin.validation.excludes String Plugin validation exclusions. - 3.9.6 User properties
maven.project.conf String Maven project configuration directory. ${session.rootDirectory}/.mvn 4.0.0 User properties
maven.project.discoverSubprojects Boolean User property for enabling/disabling automatic subproject discovery for POM-packaged projects. When set to true (default), Maven 4.1+ POM-packaged projects that do not declare <subprojects> or <modules> will automatically discover subprojects by scanning subdirectories for POM files. When set to false, automatic discovery is disabled regardless of whether <subprojects> or <modules> is declared. true 4.1.0 User properties
maven.project.extensions String Maven project extensions. ${maven.project.conf}/extensions.xml 4.0.0 User properties
maven.project.settings String Maven project settings. ${maven.project.conf}/settings.xml 4.0.0 User properties
maven.reactor.outputRepository String User property for overriding the reactor output repository path used by the reactor reader to share artifacts between modules during a build. This repository enables partial and resumable builds (e.g. mvn verify -r :module) without requiring install.

The path may be absolute or relative to the root directory. If relative, it is resolved against the root directory of the project.

Default value: ${maven.rootDirectory}/.mvn/target/project-local-repo.		 ${maven.rootDirectory}/.mvn/target/project-local-repo 4.0.0 User properties
maven.relocations.entries String User controlled relocations. This property is a comma separated list of entries with the syntax GAV>GAV. The first GAV can contain * for any elem (so *:*:* would mean ALL, something you don't want). The second GAV is either fully specified, or also can contain *, then it behaves as "ordinary relocation": the coordinate is preserved from relocated artifact. Finally, if right hand GAV is absent (line looks like GAV>), the left hand matching GAV is banned fully (from resolving).
Note: the > means project level, while >> means global (whole session level, so even plugins will get relocated artifacts) relocation.
For example, 
maven.relocations.entries = org.foo:*:*>,\ org.here:*:*>org.there:*:*,\ javax.inject:javax.inject:1>>jakarta.inject:jakarta.inject:1.0.5
means: 3 entries, ban org.foo group (exactly, so org.foo.bar is allowed), relocate org.here to org.there and finally globally relocate (see >> above) javax.inject:javax.inject:1 to jakarta.inject:jakarta.inject:1.0.5.		 - 4.0.0 User properties
maven.repo.central String Maven central repository URL. The property will have the value of the MAVEN_REPO_CENTRAL environment variable if it is defined. https://repo.maven.apache.org/maven2 4.0.0 User properties
maven.repo.local String Maven local repository. ${maven.user.conf}/repository 3.0.0 User properties
maven.repo.local.head String User property for chained LRM: the new "head" local repository to use, and "push" the existing into tail. Similar to maven.repo.local.tail, this property may contain comma separated list of paths to be used as local repositories (combine with chained local repository), but while latter is "appending" this one is "prepending". - 4.0.0 User properties
maven.repo.local.recordReverseTree String User property for reverse dependency tree. If enabled, Maven will record ".tracking" directory into local repository with "reverse dependency tree", essentially explaining WHY given artifact is present in local repository. Default: false, will not record anything. false 3.9.0 User properties
maven.repo.local.tail String User property for chained LRM: list of "tail" local repository paths (separated by comma), to be used with org.eclipse.aether.util.repository.ChainedLocalRepositoryManager. Default value: null, no chained LRM is used. - 3.9.0 User properties
maven.repo.local.tail.ignoreAvailability String User property for chained LRM: whether to ignore "availability check" in tail or not. Usually you do want to ignore it. This property is mapped onto corresponding Resolver 2.x property, is like a synonym for it. Default value: true. - 3.9.0 User properties
maven.repository.dependencyManagement.allowSystemScope Boolean User property for allowing system scope and systemPath in dependency management imported from repository-resolved POMs (BOMs).
  • When set to false (default), dependency management imported from a repository-resolved POM may not declare system scope or a systemPath; such entries are dropped with a warning.
  • When set to true, such entries are imported as in previous Maven versions, with a warning.
Dependency management imported from the local reactor is not affected by this property.		 false 4.1.0 User properties
maven.resolver.dependencyManagerTransitivity String User property for selecting dependency manager behaviour regarding transitive dependencies and dependency management entries in their POMs. Maven 3 targeted full backward compatibility with Maven2, hence it ignored dependency management entries in transitive dependency POMs. Maven 4 enables "transitivity" by default, hence unlike Maven2, obeys dependency management entries deep in dependency graph as well.
Default: true.		 true 4.0.0 User properties
maven.resolver.transport String Resolver transport to use. Can be default, wagon, apache, jdk or auto. default 4.0.0 User properties
maven.resolver.validation String Resolver validation control. Can be default (full validation), mild (only uninterpolated placeholders) or off (no validation, as in Maven 3.9.x). This configuration provides "escape hatch" for those projects, that are forced to use non-conformant solutions. default 3.10.0 User properties
maven.session.versionFilter String Builds org.eclipse.aether.collection.VersionFilter instances out of input expression string.
Expression is a semicolon separated list of filters to apply. By default, no version filter is applied (like in Maven 3).
Supported filters:
  • "s" - contextual snapshot filter (project version decides are snapshots allowed or not)
  • "nosnapshot" - unconditional snapshot filter (no snapshot versions selected from ranges)
  • "norelease" - unconditional release filter (no release versions selected from ranges)
  • "nopreview" - unconditional preview filter (no preview versions selected from ranges)
  • "noprerelease" - unconditional pre-release filter (no preview and rc/cr versions selected from ranges)
  • "noqualifier" - unconditional any-qualifier filter (no version with any qualifier selected from ranges)
  • "h" (shorthand of h(1)) or "h(num)" - highest N version (based on version ordering)
  • "l" (shorthand of l(1)) or "l(num)" - lowest N version (based on version ordering)
  • "e(V)" - exclusion filter (excludes versions matching V version constraint)
  • "i(V)" - inclusion filter (includes versions matching V version constraint)
Every filter expression may have "scope" applied, in form of @G[:A]. Presence of "scope" narrows the application of filter to given G or G:A.
In case of multiple "similar" rule scopes, user should enlist rules from "most specific" to "least specific".
Example filter expression: "h(5);s;e(1)@org.foo:bar" will cause:
  • ranges are filtered for "top 5" (instead of full range)
  • snapshots are banned if root project is not a snapshot
  • if range for org.foo:bar is being processed, version 1 is omitted
Values in this property builds org.eclipse.aether.collection.VersionFilter instance.		 - 3.10.0 User properties
maven.startInstant java.time.Instant User property used to store the build timestamp. - 4.0.0 User properties
maven.style.color String Maven output color mode. Allowed values are auto, always, never. auto 4.0.0 User properties
maven.style.debug String Color style for debug messages. bold,f:cyan 4.0.0 User properties
maven.style.error String Color style for error messages. bold,f:red 4.0.0 User properties
maven.style.failure String Color style for failure messages. bold,f:red 4.0.0 User properties
maven.style.info String Color style for info messages. bold,f:blue 4.0.0 User properties
maven.style.mojo String Color style for mojo messages. f:green 4.0.0 User properties
maven.style.project String Color style for project messages. f:cyan 4.0.0 User properties
maven.style.strong String Color style for strong messages. bold 4.0.0 User properties
maven.style.success String Color style for success messages. bold,f:green 4.0.0 User properties
maven.style.trace String Color style for trace messages. bold,f:magenta 4.0.0 User properties
maven.style.transfer String Color style for transfer messages. f:bright-black 4.0.0 User properties
maven.style.warning String Color style for warning messages. bold,f:yellow 4.0.0 User properties
maven.user.conf String Maven user configuration directory. ${user.home}/.m2 4.0.0 User properties
maven.user.extensions String Maven user extensions. ${maven.user.conf}/extensions.xml 4.0.0 User properties
maven.user.settings String Maven user settings. ${maven.user.conf}/settings.xml 4.0.0 User properties
maven.user.toolchains String Maven user toolchains. ${maven.user.conf}/toolchains.xml 4.0.0 User properties
maven.version String Maven version. - 3.0.0 System properties
maven.version.major String Maven major version: contains the major segment of this Maven version. - 4.0.0 System properties
maven.version.minor String Maven minor version: contains the minor segment of this Maven version. - 4.0.0 System properties
maven.version.patch String Maven patch version: contains the patch segment of this Maven version. - 4.0.0 System properties
maven.version.snapshot String Maven snapshot: contains "true" if this Maven is a snapshot version. - 4.0.0 System properties
maven.versionRangeResolver.natureOverride String Configuration property for version range resolution used metadata "nature". It may contain following string values:
  • "auto" - decision done based on range being resolver: if any boundary is snapshot, use "release_or_snapshot", otherwise "release"
  • "release_or_snapshot" - the default
  • "release" - query only release repositories to discover versions
  • "snapshot" - query only snapshot repositories to discover versions
Default (when unset) is using request carried nature. Hence, this configuration really makes sense with value auto, while ideally callers needs update and use newly added method on version range request to express preference.		 release_or_snapshot 4.0.0 User properties
maven.versionResolver.noCache Boolean User property for disabling version resolver cache. false 3.0.0 User properties