Installation
About
Apache Maven is a build automation and project management tool primarily used for Java-based projects. This guide provides step-by-step instructions to install Maven on Windows and macOS systems.
Prerequisites
Before installing Maven, ensure that the following prerequisites are met:
Java Development Kit (JDK)
Maven requires Java JDK 8 or higher.
Ensure Java is installed and properly configured.
To check if Java is installed
Open a terminal or command prompt and run:
java -version
This should output the installed Java version.
To check the JDK compiler
javac -version
If not installed, download and install the JDK from:
OpenJDK: https://jdk.java.net/
JAVA_HOME Environment Variable
Ensure the JAVA_HOME
environment variable is set and points to our JDK installation directory.
Downloading Apache Maven
Go to the official Maven download page: https://maven.apache.org/download.cgi
Download the binary zip archive (for Windows) or tar.gz archive (for macOS/Linux):
Example:
apache-maven-3.9.6-bin.zip
orapache-maven-3.9.6-bin.tar.gz
Verify the archive’s checksum (optional but recommended) using the instructions provided on the download page.
Installation on Windows
Step 1: Extract the Archive
Extract the
.zip
file to a preferred location, such as:C:\Program Files\Apache\Maven
Step 2: Set Environment Variables
Open System Properties > Environment Variables, and configure the following:
Add MAVEN_HOME
:
Variable Name:
MAVEN_HOME
Variable Value: path to your Maven folder, e.g.:
C:\Program Files\Apache\Maven\apache-maven-3.9.6
Add Maven bin
directory to Path
:
Edit the
Path
variable and add:%MAVEN_HOME%\bin
Step 3: Verify Installation
Open a new Command Prompt and run:
mvn -version
We should see Maven version, Java version, and our operating system.
Installation on macOS
Option 1: Install via Homebrew (recommended)
If we have Homebrew installed:
brew install maven
This will automatically handle download, setup, and path configuration.
To verify
mvn -version
Option 2: Manual Installation
Step 1: Extract the Archive
Download and extract the tar.gz
archive:
tar -xvzf apache-maven-3.9.6-bin.tar.gz
sudo mv apache-maven-3.9.6 /opt/maven
Step 2: Set Environment Variables
Add the following to your ~/.bash_profile
, ~/.zshrc
, or ~/.bashrc
(depending on your shell):
export M2_HOME=/opt/maven
export PATH=$M2_HOME/bin:$PATH
Apply the changes:
source ~/.bash_profile
# or
source ~/.zshrc
Step 3: Verify Installation
mvn -version
Last updated
Was this helpful?