Download Maven 3.0.4

Maven is distributed in several formats for your convenience. Use a source archive if you intend to build Maven yourself. Otherwise, simply pick a ready-made binary distribution and follow the installation instructions given at the end of this document.

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.

In order to guard against corrupted downloads/installations, it is highly recommended to verify the signature of the release bundles against the public KEYS used by the Apache Maven developers.

Maven is distributed under the Apache License, version 2.0.

We strongly encourage our users to configure a Maven repository mirror closer to their location, please read How to Use Mirrors for Repositories.

Be sure to check the compatibility notes before using this version to avoid surprises. While Maven 3 aims to be backward-compatible with Maven 2.x to the extent possible, there are still a few significant changes.

MirrorsChecksumSignature
Maven 3.0.4 (Binary tar.gz) apache-maven-3.0.4-bin.tar.gz apache-maven-3.0.4-bin.tar.gz.md5 apache-maven-3.0.4-bin.tar.gz.asc
Maven 3.0.4 (Binary zip) apache-maven-3.0.4-bin.zip apache-maven-3.0.4-bin.zip.md5 apache-maven-3.0.4-bin.zip.asc
Maven 3.0.4 (Source tar.gz) apache-maven-3.0.4-src.tar.gz apache-maven-3.0.4-src.tar.gz.md5 apache-maven-3.0.4-src.tar.gz.asc
Maven 3.0.4 (Source zip) apache-maven-3.0.4-src.zip apache-maven-3.0.4-src.zip.md5 apache-maven-3.0.4-src.zip.asc
Release Notes 3.0.4
Release Reference Documentation 3.0.4

You can also download the current documentation, i.e. this website, as a JAR or PDF.

Maven 2.2.1

This is an older, but stable version of Maven for projects that can't upgrade to Maven 3.x yet.

MirrorsChecksumSignature
Maven 2.2.1 (Binary tar.gz) apache-maven-2.2.1-bin.tar.gz apache-maven-2.2.1-bin.tar.gz.md5 apache-maven-2.2.1-bin.tar.gz.asc
Maven 2.2.1 (Binary zip) apache-maven-2.2.1-bin.zip apache-maven-2.2.1-bin.zip.md5 apache-maven-2.2.1-bin.zip.asc
Maven 2.2.1 (Source tar.gz) apache-maven-2.2.1-src.tar.gz apache-maven-2.2.1-src.tar.gz.md5 apache-maven-2.2.1-src.tar.gz.asc
Maven 2.2.1 (Source zip) apache-maven-2.2.1-src.zip apache-maven-2.2.1-src.zip.md5 apache-maven-2.2.1-src.zip.asc
Release Notes 2.2.1
Release Reference Documentation 2.2.1

Maven Documentation

You can download the current documentation, i.e. this website, as:

Previous Releases

All previous releases of Maven can be found in the archives.

System Requirements

JDK1.5 or above (this is to execute Maven - it still allows you to build against 1.3 and prior JDK's)
MemoryNo minimum requirement
DiskNo 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.
Operating SystemNo 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

Maven is a Java tool, so you must have Java installed in order to proceed. More precisely, you need a Java Development Kit (JDK), the Java Runtime Environment (JRE) is not sufficient.

Additional optional installation steps are listed after the platform specific instructions.

Windows 2000/XP

  1. Unzip the distribution archive, i.e. apache-maven-3.0.4-bin.zip to the directory you wish to install Maven 3.0.4. These instructions assume you chose C:\Program Files\Apache Software Foundation. The subdirectory apache-maven-3.0.4 will be created from the archive.
  2. Add the M2_HOME environment variable by opening up the system properties (WinKey + Pause), selecting the "Advanced" tab, and the "Environment Variables" button, then adding the M2_HOME variable in the user variables with the value C:\Program Files\Apache Software Foundation\apache-maven-3.0.4. Be sure to omit any quotation marks around the path even if it contains spaces. Note: For Maven < 2.0.9, also be sure that the M2_HOME doesn't have a '\' as last character.
  3. In the same dialog, add the M2 environment variable in the user variables with the value %M2_HOME%\bin.
  4. Optional: In the same dialog, add the MAVEN_OPTS 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 Path 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 JAVA_HOME exists in your user variables or in the system variables and it is set to the location of your JDK, e.g. C:\Program Files\Java\jdk1.5.0_02 and that %JAVA_HOME%\bin is in your Path environment variable.
  7. Open a new command prompt (Winkey + R then type cmd) and run mvn --version to verify that it is correctly installed.

Unix-based Operating Systems (Linux, Solaris and Mac OS X)

  1. Extract the distribution archive, i.e. apache-maven-3.0.4-bin.tar.gz to the directory you wish to install Maven 3.0.4. These instructions assume you chose /usr/local/apache-maven. The subdirectory apache-maven-3.0.4 will be created from the archive.
  2. In a command terminal, add the M2_HOME environment variable, e.g. export M2_HOME=/usr/local/apache-maven/apache-maven-3.0.4.
  3. Add the M2 environment variable, e.g. export M2=$M2_HOME/bin.
  4. Optional: Add the MAVEN_OPTS environment variable to specify JVM properties, e.g. export MAVEN_OPTS="-Xms256m -Xmx512m". This environment variable can be used to supply extra options to Maven.
  5. Add M2 environment variable to your path, e.g. export PATH=$M2:$PATH.
  6. Make sure that JAVA_HOME is set to the location of your JDK, e.g. export JAVA_HOME=/usr/java/jdk1.5.0_02 and that $JAVA_HOME/bin is in your PATH environment variable.
  7. Run mvn --version 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 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 Guide to Password Encryption.

Toolchains

As of Maven 2.0.9+, you can build a project using a specific version of JDK independent from the one Maven is running with. For more information, see the Guide to Using Toolchains.