Installing Maven

Download and configure Apache Maven for Java project management.

What You’ll Learn

• What Apache Maven is and why we use it in automation projects. (maven.apache.org)
• How to download and install the latest Maven on Windows from the official site. (maven.apache.org)
• How to configure the MAVEN_HOME environment variable. (Mkyong.com)
• How to add Maven to the PATH and verify the installation with mvn -version.

Why This Lab Matters

Maven is the standard build and dependency management tool for Java projects. Tools like Selenium test frameworks, Spring Boot apps, and CI pipelines often depend on Maven.

If Maven (or MAVEN_HOME) is misconfigured, you will face issues like:

• mvn is not recognized as an internal or external command
• Projects failing to build due to missing dependencies

Getting Maven installed correctly once saves a lot of debugging time later. (maven.apache.org)

Prerequisites

Before starting, make sure you have:

• Operating System: Windows 10 or Windows 11
• Java JDK installed and JAVA_HOME set (e.g., JDK 21 or 25)
• Admin access (you can open and edit System Environment Variables)
• A stable internet connection to download Maven

Core Concepts

Apache Maven

A build automation and dependency management tool for Java projects. It uses a pom.xml file to define dependencies, plugins, and build steps. (maven.apache.org)

MAVEN_HOME

A system environment variable pointing to the root folder where Maven is installed, e.g.:
C:\Tools\apache-maven-3.9.11

PATH variable

A system variable that tells Windows where to search for executables.
Adding %MAVEN_HOME%\bin to Path lets you run mvn from any terminal.

Latest Maven version

As of now, the latest stable Maven 3.x release is Apache Maven 3.9.11. Maven 4 is still in release-candidate stage, so 3.9.x is the recommended production choice. (maven.apache.org)

Step 1 – Download the Latest Apache Maven

1. Open your browser and go to the official Apache Maven Download page. (maven.apache.org)
2. Scroll down to the Files section.
3. Under Binary zip archive, download the file named similar to:
   apache-maven-3.9.11-bin.zip

   (The exact version number may be newer; always pick the latest.)

Step 2 – Extract Maven to a Permanent Folder

Maven doesn’t have an installer. You just extract the zip.

1. Locate the downloaded zip file, e.g. in your Downloads folder:
   C:\Users\<YourUser>\Downloads\apache-maven-3.9.11-bin.zip
2. Right-click the zip file → Extract All…
3. Choose a permanent tools location, for example:
   C:\Tools\apache-maven-3.9.11
4. Confirm extraction.

Step 3 – Copy the Installation Path

1. Open File Explorer and navigate to your Maven folder:
   C:\Tools\apache-maven-3.9.11
2. Click in the address bar and copy the full path (Ctrl + C).
   You’ll use this path as the value for MAVEN_HOME.

Step 4 – Create the MAVEN_HOME Environment Variable

1. Press the Windows key, type environment variables.
2. Click Edit the system environment variables. (phoenixNAP)
3. In the System Properties window, go to the Advanced tab.
4. Click Environment Variables…
5. Under System variables, click New…
6. Fill in:
   • Variable name: MAVEN_HOME
   • Variable value: paste your Maven folder path, e.g.
     C:\Tools\apache-maven-3.9.11
7. Click OK to save.

Step 5 – Add Maven to the PATH (So mvn Works Everywhere)

1. In the same Environment Variables window, under System variables, find Path.
2. Select Path and click Edit…
3. Click New and add:
   %MAVEN_HOME%\bin
4. Click OK on all windows to close and save.

Now, every new terminal window will know where mvn.exe lives. (phoenixNAP)

Step 6 – Verify Maven Installation

1. Close any open Command Prompt / PowerShell windows.
2. Open a new Command Prompt (cmd) window.
3. Run:
   Command Prompt

   echo %MAVEN_HOME%

   You should see your Maven directory printed, for example:

   Output

   C:\Tools\apache-maven-3.9.11

4. Then run:
   Command Prompt

   mvn -version

   You should see an output similar to:

   Output

   Apache Maven 3.9.11 (…)
   Maven home: C:\Tools\apache-maven-3.9.11
   Java version: 21.0.x, vendor: Oracle Corporation
   OS name: "Windows 11", version: "10.0", arch: "amd64", family: "windows"

Code Example

Here are the exact commands you’ll use to validate your setup on Windows:

:: Check MAVEN_HOME
echo %MAVEN_HOME%

:: Check Maven version and Java integration
mvn -version

Pro Tips (From Real Projects)

• Pin a Maven Version Per Machine: Don't constantly switch Maven versions on the same machine unless you really need to. It helps avoid "works on my machine" issues.
• Use a Dedicated Tools Folder: Keep JDK, Maven, Gradle, etc. under something like C:\Tools or C:\DevTools to keep paths clean and predictable.
• Document Your Setup: Note down Maven version, JDK version, and installation paths. This is gold when you're setting up CI pipelines or onboarding teammates.
• Restart IDEs After Changes: If you changed JAVA_HOME or MAVEN_HOME, restart IntelliJ / VS Code so they pick up the new environment variables.
• Keep Maven Updated: Check the official site occasionally and upgrade to the latest stable 3.x release to benefit from fixes and improvements. (maven.apache.org)

Common Mistakes to Avoid

• Pointing MAVEN_HOME to the wrong folder
  Using ...apache-maven-3.9.11\bin instead of ...apache-maven-3.9.11.
• Forgetting to open a new terminal
  Old Command Prompt windows don’t see newly-added environment variables.
• Not having Java installed first
  Maven requires a JDK. If Java isn’t installed or JAVA_HOME is wrong, mvn -version will fail. (maven.apache.org)
• Overwriting the Path variable by mistake
  Always append %MAVEN_HOME%\bin; don’t delete existing entries.
• Downloading from random websites
  This can give you outdated or unsafe binaries. Always use the official Apache Maven download page.