Maven Properties

This document describes the various properties that can be overridden to change the default behavior of Maven. If you need to override any of these properties, please refer to the Integration document for the preferred method of setting properties in your project.

Section Description
User These properties specify various settings that control a user's individual Maven settings.
Directory Layout These properties specify the directory layout specifications that Maven uses as documented in the Directory Layout document. It is not recommended that these values be overridden.
Miscellaneous These properties specify miscellaneous settings that do not fit into any of the above categories.

User Settings

Property Optional? Description
maven.repo.remote Yes Specifies a comma separated list of URLs to one or more central JAR repositories used to download the dependencies required by the project. These repositories also contain distributions of the projects. The default value of this property is http://http://www.ibiblio.org/maven.
maven.username No Specifies the username to use when connecting to a remote site via SSH and other remote activities. Typically, this property is set in a user's ${user.home}/build.properties flie or specified on the Ant command-line.
maven.proxy.host Yes Specifies a proxy server to use when downloading JARs.
maven.proxy.port Yes Specifies the port of the proxy server to use when downloading JARs.
maven.proxy.username Yes Specifies a proxy username for proxy authentication.
maven.proxy.password Yes Specifies a proxy password for proxy authentication.

Directory Layout Settings

Property Optional? Description
maven.src.dir Yes Specifies the top-level source directory of the project. This is used as the base directory for various goals in many plugins. The default value is ${basedir}/src.
maven.conf.dir Yes Specifies the directory containing configuration files for some plugins. The default value is ${basedir}/conf.
maven.build.dir Yes Specifies the build directory for the project. Used by many of the plugins. The default value is ${basedir}/target.
maven.build.src Yes This property is currently not used. The default value is ${build.dir}/src.
maven.build.dest Yes Specifies the location where compiled Java classes are stored. The default value is ${build.dir}/classes.
maven.jarResources.basedir Yes Specifies the location where resources to be placed in jar files are found. The default value is ${basedir}. This value specifies where to find resources specified by the <jarResources;> element in project.xml

Miscellaneous Settings

Property Optional? Description
maven.final.name Yes Specifies the name of the JAR file and distribution packages that are generated with "jar" and "dist" goals. The default value is ${maven.id}-${maven.currentVersion}. ${maven.id} and ${maven.currentVersion} expand to values obtained from the project descriptor.
maven.updateSite Yes This property is currently not used. The default value is http://www.apache.org/~jvanzyl/maven/update.