------ Download Maven ------ Brett Porter Jason van Zyl John Casey ------ 30 June 2009 ------ ~~ Licensed to the Apache Software Foundation (ASF) under one ~~ or more contributor license agreements. See the NOTICE file ~~ distributed with this work for additional information ~~ regarding copyright ownership. The ASF licenses this file ~~ to you under the Apache License, Version 2.0 (the ~~ "License"); you may not use this file except in compliance ~~ with the License. You may obtain a copy of the License at ~~ ~~ http://www.apache.org/licenses/LICENSE-2.0 ~~ ~~ Unless required by applicable law or agreed to in writing, ~~ software distributed under the License is distributed on an ~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY ~~ KIND, either express or implied. See the License for the ~~ specific language governing permissions and limitations ~~ under the License. ~~ NOTE: For help with the syntax of this file, see: ~~ http://maven.apache.org/doxia/references/apt-format.html Download Maven ${currentStableVersion} Maven is distributed in several formats for your convenience. You will be prompted for a mirror - if the file is not found on yours, please be patient, as it may take 24 hours to reach all mirrors. Maven is distributed under the {{{http://maven.apache.org/license.html} Apache License, version 2.0}}. We <> encourage our users to configure a Maven repository mirror closer to their location, please read {{{./guides/mini/guide-mirror-settings.html} How to Use Mirrors for Repositories}}. *-------------------------+---------+----------+-----------+ | | Mirrors | Checksum | Signature | *-------------------------+---------+----------+-----------+ | Maven ${currentStableVersion} (tar.bz2) | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-${currentStableVersion}-bin.tar.bz2} apache-maven-${currentStableVersion}-bin.tar.bz2}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentStableVersion}-bin.tar.bz2.md5} apache-maven-${currentStableVersion}-bin.tar.bz2.md5}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentStableVersion}-bin.tar.bz2.asc} apache-maven-${currentStableVersion}-bin.tar.bz2.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${currentStableVersion} (tar.gz) | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-${currentStableVersion}-bin.tar.gz} apache-maven-${currentStableVersion}-bin.tar.gz}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentStableVersion}-bin.tar.gz.md5} apache-maven-${currentStableVersion}-bin.tar.gz.md5}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentStableVersion}-bin.tar.gz.asc} apache-maven-${currentStableVersion}-bin.tar.gz.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${currentStableVersion} (zip) | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-${currentStableVersion}-bin.zip} apache-maven-${currentStableVersion}-bin.zip}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentStableVersion}-bin.zip.md5} apache-maven-${currentStableVersion}-bin.zip.md5}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentStableVersion}-bin.zip.asc} apache-maven-${currentStableVersion}-bin.zip.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${currentStableVersion} (Source tar.gz) | {{{http://www.apache.org/dyn/closer.cgi/maven/source/apache-maven-${currentStableVersion}-src.tar.gz} apache-maven-${currentStableVersion}-src.tar.gz}} | {{{http://www.apache.org/dist/maven/source/apache-maven-${currentStableVersion}-src.tar.gz.md5} apache-maven-${currentStableVersion}-src.tar.gz.md5}} | {{{http://www.apache.org/dist/maven/source/apache-maven-${currentStableVersion}-src.tar.gz.asc} apache-maven-${currentStableVersion}-src.tar.gz.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${currentStableVersion} (Source zip) | {{{http://www.apache.org/dyn/closer.cgi/maven/source/apache-maven-${currentStableVersion}-src.zip} apache-maven-${currentStableVersion}-src.zip}} | {{{http://www.apache.org/dist/maven/source/apache-maven-${currentStableVersion}-src.zip.md5} apache-maven-${currentStableVersion}-src.zip.md5}} | {{{http://www.apache.org/dist/maven/source/apache-maven-${currentStableVersion}-src.zip.asc} apache-maven-${currentStableVersion}-src.zip.asc}} | *-------------------------+---------+----------+-----------+ | Release Notes | {{{./docs/${currentStableVersion}/release-notes.html} ${currentStableVersion}}} | | | *-------------------------+---------+----------+-----------+ You could also download the current documentation, i.e. this website, as a {{{Maven_Documentation}JAR or PDF}}. * {Maven ${current20xVersion}} This is an older, but stable version of Maven for projects that require Maven to run on JDK 1.4. *-------------------------+---------+----------+-----------+ | | Mirrors | Checksum | Signature | *-------------------------+---------+----------+-----------+ | Maven ${current20xVersion} (tar.bz2) | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-${current20xVersion}-bin.tar.bz2} apache-maven-${current20xVersion}-bin.tar.bz2}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${current20xVersion}-bin.tar.bz2.md5} apache-maven-${current20xVersion}-bin.tar.bz2.md5}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${current20xVersion}-bin.tar.bz2.asc} apache-maven-${current20xVersion}-bin.tar.bz2.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${current20xVersion} (tar.gz) | {{{http://www.apache.org/dyn/closer.cgi?path=/maven/binaries/apache-maven-${current20xVersion}-bin.tar.gz} apache-maven-${current20xVersion}-bin.tar.gz}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${current20xVersion}-bin.tar.gz.md5} apache-maven-${current20xVersion}-bin.tar.gz.md5}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${current20xVersion}-bin.tar.gz.asc} apache-maven-${current20xVersion}-bin.tar.gz.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${current20xVersion} (zip) | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-${current20xVersion}-bin.zip} apache-maven-${current20xVersion}-bin.zip}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${current20xVersion}-bin.zip.md5} apache-maven-${current20xVersion}-bin.zip.md5}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${current20xVersion}-bin.zip.asc} apache-maven-${current20xVersion}-bin.zip.asc}} | *-------------------------+---------+----------+-----------+ | Release Notes | {{{./docs/${current20xVersion}/release-notes.html} ${current20xVersion}}} | | | *-------------------------+---------+----------+-----------+ * {Maven ${currentDevelopmentVersion}} Unstable preview releases of Maven 3 are also available. *-------------------------+---------+----------+-----------+ | | Mirrors | Checksum | Signature | *-------------------------+---------+----------+-----------+ | Maven ${currentDevelopmentVersion} (tar.gz) | {{{http://www.apache.org/dyn/closer.cgi?path=/maven/binaries/apache-maven-${currentDevelopmentVersion}-bin.tar.gz} apache-maven-${currentDevelopmentVersion}-bin.tar.gz}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentDevelopmentVersion}-bin.tar.gz.md5} apache-maven-${currentDevelopmentVersion}-bin.tar.gz.md5}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentDevelopmentVersion}-bin.tar.gz.asc} apache-maven-${currentDevelopmentVersion}-bin.tar.gz.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${currentDevelopmentVersion} (zip) | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-${currentDevelopmentVersion}-bin.zip} apache-maven-${currentDevelopmentVersion}-bin.zip}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentDevelopmentVersion}-bin.zip.md5} apache-maven-${currentDevelopmentVersion}-bin.zip.md5}} | {{{http://www.apache.org/dist/maven/binaries/apache-maven-${currentDevelopmentVersion}-bin.zip.asc} apache-maven-${currentDevelopmentVersion}-bin.zip.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${currentDevelopmentVersion} (Source tar.gz) | {{{http://www.apache.org/dyn/closer.cgi?path=/maven/source/apache-maven-${currentDevelopmentVersion}-src.tar.gz} apache-maven-${currentDevelopmentVersion}-src.tar.gz}} | {{{http://www.apache.org/dist/maven/source/apache-maven-${currentDevelopmentVersion}-src.tar.gz.md5} apache-maven-${currentDevelopmentVersion}-src.tar.gz.md5}} | {{{http://www.apache.org/dist/maven/source/apache-maven-${currentDevelopmentVersion}-src.tar.gz.asc} apache-maven-${currentDevelopmentVersion}-src.tar.gz.asc}} | *-------------------------+---------+----------+-----------+ | Maven ${currentDevelopmentVersion} (Source zip) | {{{http://www.apache.org/dyn/closer.cgi/maven/source/apache-maven-${currentDevelopmentVersion}-src.zip} apache-maven-${currentDevelopmentVersion}-src.zip}} | {{{http://www.apache.org/dist/maven/source/apache-maven-${currentDevelopmentVersion}-src.zip.md5} apache-maven-${currentDevelopmentVersion}-src.zip.md5}} | {{{http://www.apache.org/dist/maven/source/apache-maven-${currentDevelopmentVersion}-src.zip.asc} apache-maven-${currentDevelopmentVersion}-src.zip.asc}} | *-------------------------+---------+----------+-----------+ | Release Notes | {{{./docs/${currentDevelopmentVersion}/release-notes.html} ${currentDevelopmentVersion}}} | | | *-------------------------+---------+----------+-----------+ * {Maven Documentation} You could download the current documentation, i.e. this website, as: * a {{{./maven-site-1.0-site.jar}single jar}} file; * a {{{./apache-maven.pdf}PDF}} file. [] * {Maven Ant Tasks} Detailed information about the Maven Ant tasks can be found on the {{{http://maven.apache.org/ant-tasks}project site}}. *-------------------------+---------+----------+-----------+ | | Mirrors | Checksum | Signature | *-------------------------+---------+----------+-----------+ | Maven Ant Tasks 2.0.10 | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-ant-tasks-2.0.10.jar} maven-ant-tasks-2.0.10.jar}} | {{{http://www.apache.org/dist/maven/binaries/maven-ant-tasks-2.0.10.jar.md5} maven-ant-tasks-2.0.10.jar.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-ant-tasks-2.0.10.jar.asc} maven-ant-tasks-2.0.10.jar.asc}} | *-------------------------+---------+----------+-----------+ | Sources (zip) | {{{http://www.apache.org/dyn/closer.cgi/maven/source/maven-ant-tasks-2.0.10-src.zip} maven-ant-tasks-2.0.10-src.zip}} | {{{http://www.apache.org/dist/maven/source/maven-ant-tasks-2.0.10-src.zip.md5} maven-ant-tasks-2.0.10-src.zip.md5}} | {{{http://www.apache.org/dist/maven/source/maven-ant-tasks-2.0.10-src.zip.asc} maven-ant-tasks-2.0.10-src.zip.asc}} | *-------------------------+---------+----------+-----------+ | Sources (tar.gz) | {{{http://www.apache.org/dyn/closer.cgi?path=/maven/source/maven-ant-tasks-2.0.10-src.tar.gz} maven-ant-tasks-2.0.10-src.tar.gz}} | {{{http://www.apache.org/dist/maven/source/maven-ant-tasks-2.0.10-src.tar.gz.md5} maven-ant-tasks-2.0.10-src.tar.gz.md5}} | {{{http://www.apache.org/dist/maven/source/maven-ant-tasks-2.0.10-src.tar.gz.asc} maven-ant-tasks-2.0.10-src.tar.gz.asc}} | *-------------------------+---------+----------+-----------+ * Previous Releases All previous releases of Maven can be found in the {{{http://archive.apache.org/dist/maven/binaries/}archives}}. * System {Requirements} *----------------------+---------------------------------------------------------------------------------------------+ | <> | 1.5 or above (this is to execute Maven - it still allows you to build against 1.3 and prior JDK's) *----------------------+---------------------------------------------------------------------------------------------+ | <> | No minimum requirement *----------------------+---------------------------------------------------------------------------------------------+ | <> | No minimum requirement. Approximately 100MB will be used for your local repository, however this will vary depending on usage and can be removed and redownloaded at any time. *----------------------+---------------------------------------------------------------------------------------------+ | <> | No minimum requirement. On Windows, Windows NT and above or Cygwin is required for the startup scripts. Tested on Windows XP, Fedora Core and Mac OS X. *----------------------+---------------------------------------------------------------------------------------------+ * {Installation} Instructions Additional optional installation steps are listed after the platform specific instructions. ~~ NOTE: ~~ At least Windows users seem to be confused if the instructions contain quotation marks because people included them ~~ literally in the environment variables which does not work. For this reason, literal values are only printed using ~~ type-writer face without any surrounding quotations marks unless these are expected to be typed by the user, too. ** Windows 2000/XP [[1]] Unzip the distribution archive, i.e. <<>> to the directory you wish to install Maven ${currentStableVersion}. These instructions assume you chose <<>>. The subdirectory <<>> will be created from the archive. [[2]] Add the <<>> environment variable by opening up the system properties (WinKey + Pause), selecting the "Advanced" tab, and the "Environment Variables" button, then adding the <<>> variable in the user variables with the value <<>>. Be sure to omit any quotation marks around the path even if it contains spaces. <>: For Maven \< 2.0.9, also be sure that the <<>> doesn't have a '\' as last character. [[3]] In the same dialog, add the <<>> environment variable in the user variables with the value <<<%M2_HOME%\bin>>>. [[4]] <>: In the same dialog, add the <<>> environment variable in the user variables to specify JVM properties, e.g. the value <<<-Xms256m -Xmx512m>>>. This environment variable can be used to supply extra options to Maven. [[5]] In the same dialog, update/create the <<>> environment variable in the user variables and prepend the value <<<%M2%>>> to add Maven available in the command line. [[6]] In the same dialog, make sure that <<>> exists in your user variables or in the system variables and it is set to the location of your JDK, e.g. <<>> and that <<<%JAVA_HOME%\bin>>> is in your <<>> environment variable. [[7]] Open a command prompt (Winkey + R then type <<>>) and run <<>> to verify that it is correctly installed. ** Unix-based Operating Systems (Linux, Solaris and Mac OS X) [[1]] Extract the distribution archive, i.e. <<>> to the directory you wish to install Maven ${currentStableVersion}. These instructions assume you chose <<>>. The subdirectory <<>> will be created from the archive. [[2]] In a command terminal, add the <<>> environment variable, e.g. <<>>. [[3]] Add the <<>> environment variable, e.g. <<>>. [[4]] <>: Add the <<>> environment variable to specify JVM properties, e.g. <<>>. This environment variable can be used to supply extra options to Maven. [[5]] Add <<>> environment variable to your path, e.g. <<>>. [[6]] Make sure that <<>> is set to the location of your JDK, e.g. <<>> and that <<<$JAVA_HOME/bin>>> is in your <<>> environment variable. [[7]] Run <<>> to verify that it is correctly installed. ** Optional configuration Maven will work for most tasks with the above configuration, however if you have any environmental specific configuration outside of individual projects then you will need to configure settings. The following sections refer to what is available. *** Settings Maven has a settings file located in the Maven installation and/or user home directory that configure environmental specifics such as: * HTTP proxy server * repository manager location * server authentication and passwords * other configuration properties For information on this file, see the {{{./settings.html} Settings reference}} *** Security As of Maven 2.1.0+, you can encrypt passwords in your settings file, however you must first configure a master password. For more information on both server passwords and the master password, see the {{{./guides/mini/guide-encryption.html} Guide to password encryption}}.