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. If you like my tutorials, consider make a donation to these charities.

Comments

avatar
324 Comment threads
78 Thread replies
2 Followers
 
Most reacted comment
Hottest comment thread
355 Comment authors
asdAnirban ChatterjeeMananaKesika JeevathayaparanJITHENDAR Recent comment authors
newest oldest most voted
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.

Suhas
Guest
Suhas

Run CMD as administrator and then type command mvn -version

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.

Ivan
Guest
Ivan

This. Thank you!

Sanskriti
Guest
Sanskriti

Its working with directly adding the path , rather than setting MAVEN_HOME and then giving path in Environment varibale >> System variable > path

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.

QA Bob
Guest
QA Bob

One special note. If you add MAVEN_HOME as a User defined variable and you do not add this as a SYSTEM variable then the Path will NOT see it. You need to add this as a SYSTEM Variable then the Path reference will see the MAVEN_HOME. “User Var: MAVEN_HOME = C:\apache-maven-3.5.4 SYSTEM Var: MAVEN_HOME = C:\apache-maven-3.5.4 , AND I added this to Path = %MAVEN_HOME%\bin; ” I added the ” ” in order for this forums settings to NOT strip out the “/” Note: JAVA_HOME needs to be set correctly as well to the location your JDK or JRE has… Read more »

yans
Guest
yans

Works for me.

Manana
Guest
Manana

i tried your method, did not work for me :(

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!

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)

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.

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 »

Brunda
Guest
Brunda

This worked for me! Thanks much!!!

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

Que
Guest
Que

Thank you, I had to run CMD as administrator though

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.

hugo
Guest
hugo

echo $JAVA_HOME

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

William M
Guest
William M

thanks a lot

Alia
Guest
Alia

This post helped me. Thanks for sharing.

kyler
Guest
kyler

I like squirrels

kyler
Guest
kyler

china numbah 1!!!!

Ashutosh Kushwaha
Guest
Ashutosh Kushwaha

Helpful, thanks buddy

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 »

Kidus M.Tekeste
Guest
Kidus M.Tekeste

Thanks man!
very clear steps!

David
Guest
David

thanks worked great

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!

VeaceslavKunitki
Guest
VeaceslavKunitki

mvn — version
not mvn -version
double minuses

Alde
Guest
Alde

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

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