How to install Maven on Windows

To install Apache Maven on Windows, you just need to download the Maven’s zip file, unzip it to a folder, and configure the Windows environment variables.

Tested with :

  1. JDK 10
  2. Maven 3.6
  3. Windows 10
Note

  1. Maven 3.3+ requires JDK 1.7+
  2. Maven 3.2 requires JDK 1.6+
  3. Maven 3.0/3.1 requires JDK 1.5+

1. JDK and JAVA_HOME

Make sure JDK is installed, and JAVA_HOME environment variable is configured.

Note
Please read this how to add JAVA_HOME on Windows 10

2. Download Apache Maven

2.1 Visit Maven official website, download the Maven zip file, for example : apache-maven-3.6.0-bin.zip.

2.2 Unzip it to a folder. In this article, we are using c:\opt\apache-maven-3.6.0

Note
That’s all, just download and unzip, installation is NOT required.

3. Add MAVEN_HOME system variable

Add a MAVEN_HOME system variables, and point it to the Maven folder.

3.1 Press Windows key, type adva and clicks on the View advanced system settings

3.2 In System Properties dialog, select Advanced tab and clicks on the Environment Variables... button.

3.3 In “Environment variables” dialog, System variables, Clicks on the New... button and add a MAVEN_HOME variable and point it to c:\opt\apache-maven-3.6.0

4. Add %MAVEN_HOME%\bin To PATH

In system variables, find PATH, clicks on the Edit... button. In “Edit environment variable” dialog, clicks on the New button and add this %MAVEN_HOME%\bin

5. Verification

Done, start a new command prompt, type mvn –version :


C:\Users\mkyong>mvn -version
Apache Maven 3.6.0 (97c98ec64a1fdfee7767ce5ffb20918da4f719f3; 2018-10-25T02:41:47+08:00)
Maven home: C:\opt\apache-maven-3.6.0\bin\..
Java version: 10.0.1, vendor: Oracle Corporation, runtime: C:\opt\Java\jdk-10
Default locale: en_MY, platform encoding: Cp1252
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

C:\Users\mkyong>echo %MAVEN_HOME%
C:\opt\apache-maven-3.6.0

The Apache Maven is installed successfully on Windows.

6. FAQs

6.1 ‘mvn’ is not recognized as an internal or external command?


> mvn -version
'mvn' is not recognized as an internal or external command,
operable program or batch file.

Answer: Refer to Step 4, make sure the %MAVEN_HOME%\bin is added to the PATH system variable.

6.2 The JAVA_HOME environment variable is not defined correctly


> mvn -version
The JAVA_HOME environment variable is not defined correctly
This environment variable is needed to run this program
NB: JAVA_HOME should point to a JDK not a JRE

Answer: Refer to Step 2, make sure JDK is installed and the JAVA_HOME system variable is configured.

References

  1. How to add JAVA_HOME on Windows 10

About the Author

author image
mkyong
Founder of Mkyong.com, love Java and open source stuff. Follow him on Twitter, or befriend him on Facebook or Google Plus. If you like my tutorials, consider make a donation to these charities.

Comments

avatar
299 Comment threads
67 Thread replies
2 Followers
 
Most reacted comment
Hottest comment thread
320 Comment authors
LilianaNareshtrue421DjiBensumanth Recent comment authors
newest oldest most voted
Kunal Gautam
Guest
Kunal Gautam

Also, had to add env variable with name ‘mvn’ and direct it to the bin folder, and then it was smooth sailing for me.

Kishor Kumar
Guest
Kishor Kumar

Can you explain more how did u add mvn env variable directing to bin . Cause my mvn cmd is not recognised even after adding mvn variable

sharmi
Guest
sharmi

Adding the variable directing to bin under Path is given above. And, then to run the mvn command successfully, you’ll have to first navigate to the folder where maven folder has been placed.

mai magdy
Guest
mai magdy

i have an error while running mvn -version saying : notrecognized command as external or internal command ,knowing that i have added MAVEN_HOME IN the system variables …so any idea how to fix it ??…thanks

Priya
Guest
Priya

Even i faced the same problem. Create a ‘mvn’ env variable it will work fine.

Guna
Guest
Guna

I had the same issue. I restarted cmd, then tried again ‘mvn -version’. It worked.

Rupali
Guest
Rupali

thanks a lot @Guna

Vigneshbabu
Guest
Vigneshbabu

I just tried the steps mentioned in the above blog (not any comments), restarted cmd and it worked fine.

Sahaj Arora
Guest
Sahaj Arora

It didn’t work for me.
To make it work, In Path variable, instead of adding %M2_HOME%bin, I added C:Program FilesApachemavenbin.
And voila! it worked!

Yuva Yuvi
Guest
Yuva Yuvi

This post helped a lot. If anyone have the following issue “Error: Could not find or load main class org.codehaus.plexus.classworlds.launcher.Launcher”. Download Binary zip archive files, Instead of downloading Source zip archives.

Manikanta Kumar
Guest
Manikanta Kumar

You are correct. Binary.zip should be downloaded.

Paresh Chavhan
Guest
Paresh Chavhan

Hi
Actually, i am facing the problem when type command prompt mvn -version the error shows like that
C:Usersjkj>mvn -version
The JAVA_HOME environment variable is not defined correctly
This environment variable is needed to run this program
NB: JAVA_HOME should point to a JDK, not a JRE

But Java Home is already set and when enter command prompt like Java -Version
C:Usersjkj>java -version
java version “1.8.0_161”
Java(TM) SE Runtime Environment (build 1.8.0_161-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.161-b12, mixed mode)
so how to overcome this problem plz guide me asap…

Ahmad Hamdan
Guest
Ahmad Hamdan

JAVA_HOME variable should not contain /bin directory in its path
(example that worked for me: JAVA_HOME=C:\Program Files\Java\jdk1.7.0_76)

Raj Kumar Kundu
Guest
Raj Kumar Kundu

mvn –version did not work for me. It was giving “BUILD FAILURE”. I had to use mvn –version (note double dash). Please note that I am using following environment:
Windows 7
Maven 3.3.9
Java 7

Agyeya Gupta
Guest
Agyeya Gupta

mvn –version
That’s with 2 hyphens

Lisa Kristinardottir
Guest
Lisa Kristinardottir

Hi all: This works in Windows 10 latest with all updates as of Dec. 22, 2017. Unzip maven zip file to any folder. e..g c:Program Files is recommended for Windows 10. Like into c:Program FilesApacheMaven like I gave here. Every setup given here is fine. Just also MAKE SURE that you do the mvn variable setting (in BOTH user and system sections to make sure it catches it everywhere, to allow you to run Maven everywhere) and and in the path, i.e. %mvn%bin. Close command terminal window and reopen a new one. run: mvn -v or mvn –version Output will… Read more »

Que
Guest
Que

Thank you, I had to run CMD as administrator though

kyler
Guest
kyler

I like squirrels

kyler
Guest
kyler

china numbah 1!!!!

César Peñate
Guest
César Peñate

this article work for me on windows 10, thanks.

Mayuresh Trivedi
Guest
Mayuresh Trivedi

Use mvn -v

junior
Guest
junior

This is the most accurate tutorial about setting up maven in Windows. Working fine in Windows 10. Just need to pay attention in every step. Thank you!

William M
Guest
William M

thanks a lot

Alia
Guest
Alia

This post helped me. Thanks for sharing.

Kidus M.Tekeste
Guest
Kidus M.Tekeste

Thanks man!
very clear steps!

David
Guest
David

thanks worked great

Deep Xavier
Guest
Deep Xavier

I can’t run mvn command in Git Bash but works just fine in the Windows command prompt. I assume that this has to do with my user access rights which is not system administrator level. Any workaround on this one? Or any one experience the same situation and has resolve it. I’ve done everything I’ve found from the net for the possible solution but nothing works. BTW, I am running on a Windows 10 machine. Thanks.

VeaceslavKunitki
Guest
VeaceslavKunitki

mvn — version
not mvn -version
double minuses

Ashutosh Kushwaha
Guest
Ashutosh Kushwaha

Helpful, thanks buddy

Alde
Guest
Alde

I didnt add ‘%M2_HOME%bin’ to the system environment variables! Thanks for this.

Vikas
Guest
Vikas

While running command using mvn -version i got error. Microsoft Windows [Version 6.3.9600] (c) 2013 Microsoft Corporation. All rights reserved. C:UsersVik>mvn __V Cannot find function ext-ms-win-cmd-util-l1-1-0.dll:CmdBatNotificationStub. is not a valid Win32 application. [INFO] Scanning for projects… [INFO] ———————————————————————— [INFO] BUILD FAILURE [INFO] ———————————————————————— [INFO] Total time: 0.100 s [INFO] Finished at: 2018-01-25T12:35:55+05:30 [INFO] Final Memory: 10M/109M [INFO] ———————————————————————— [ERROR] The goal you specified requires a project to execute but there is no POM in this directory (C:UsersVik). Please verify you invoked Maven from the correct directory. -> [Help 1] [ERROR] [ERROR] To see the full stack trace of the errors,… Read more »

Reynaldo Pakpahan
Guest
Reynaldo Pakpahan

thanks for tutorial, it’s really great and easy to follow ur lead, thanks!

zahra khoobi
Guest
zahra khoobi

thanks!

Reshmi
Guest
Reshmi

Thank you. It helped.

Kelton
Guest
Kelton

Hi.. Thanks a lot for your help. Very simple and accurate. Worked fine for me on Windows 7.

teoman
Guest
teoman

Amazing tutorial, thanks a lot!

Riski
Guest
Riski

thanks a lot

farha
Guest
farha

Thanks!!

Florian Thiery
Guest
Florian Thiery

perfect, thx!

Jose
Guest
Jose

Thanks as usually