How To Install Maven In Linux – System Path Variable Configuration

by

Installing Maven in Linux begins with ensuring Java is already installed on your system. This guide covers exactly how to install Maven in Linux step by step, whether you are using Ubuntu, Debian, Fedora, or CentOS. By the end, you will have a fully functional Maven build environment ready for your Java projects.

Maven is a powerful build automation tool used primarily for Java projects. It simplifies dependency management, project builds, and documentation generation. Many developers rely on Maven for consistent project structures and reproducible builds. This article will walk you through the entire installation process, from checking prerequisites to verifying your setup.

Prerequisites For Installing Maven

Before you begin, ensure your Linux system meets the minimum requirements. The most important prerequisite is Java Development Kit (JDK) version 8 or higher. Maven itself is written in Java, so it needs a JRE or JDK to run.

Check if Java is already installed by running this command in your terminal:

java -version

If Java is not installed, you will need to install it first. For Ubuntu or Debian-based systems, use:

sudo apt update
sudo apt install default-jdk

For Red Hat-based systems like Fedora or CentOS, use:

sudo dnf install java-11-openjdk-devel

Verify the Java installation again after installing. You should see output showing the Java version. Also check that the JAVA_HOME environment variable is set correctly, as Maven uses it during builds.

How To Install Maven In Linux

Now that Java is ready, you can proceed with the Maven installation. There are several methods to install Maven on Linux, but the most common and recommended approach is using the official Apache Maven tarball. This method gives you the latest stable version and works across all Linux distributions.

Method 1: Install Maven Using APT Package Manager

For Ubuntu, Debian, and other Debian-based distributions, you can install Maven directly from the official repositories. This method is simpler but may not always provide the latest version. Open your terminal and run:

sudo apt update
sudo apt install maven

After installation, verify the version with:

mvn -version

This method installs Maven to /usr/share/maven by default. It also sets up the necessary environment variables automatically. However, the version available in the repositories might be older than the latest release. For most users, this is perfectly fine, but if you need the newest features, consider the manual installation method.

Method 2: Install Maven From Official Apache Tarball

This method gives you complete control over the Maven version. It works on any Linux distribution and ensures you get the latest stable release. Follow these steps carefully:

  1. Visit the official Apache Maven download page to find the latest version URL. As of writing, the latest stable version is 3.9.6.
  2. Download the tarball using wget or curl. For example:
wget https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
  1. Extract the tarball to /opt directory (or any preferred location):
sudo tar -xzf apache-maven-3.9.6-bin.tar.gz -C /opt
  1. Create a symbolic link for easier version management:
sudo ln -s /opt/apache-maven-3.9.6 /opt/maven
  1. Set up environment variables by creating a new file in /etc/profile.d/:
sudo nano /etc/profile.d/maven.sh

Add the following lines to the file:

export M2_HOME=/opt/maven
export MAVEN_HOME=/opt/maven
export PATH=${M2_HOME}/bin:${PATH}

Save the file and make it executable:

sudo chmod +x /etc/profile.d/maven.sh

Load the environment variables into your current session:

source /etc/profile.d/maven.sh

Verify the installation by checking the Maven version:

mvn -version

You should see output similar to:

Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae)
Maven home: /opt/maven
Java version: 11.0.18, vendor: Ubuntu, runtime: /usr/lib/jvm/java-11-openjdk-amd64
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "5.15.0-91-generic", arch: "amd64", family: "unix"

Method 3: Install Maven Using Snap Package

If you prefer snap packages, Maven is also available through Snapcraft. This method is quick and handles updates automatically. Install Maven using:

sudo snap install maven --classic

The –classic flag is required because Maven needs full access to your system. After installation, verify with mvn -version. Snap installations are isolated, which can be both an advantage and a limitation depending on your workflow.

Configuring Maven After Installation

Once Maven is installed, you may want to configure it for optimal performance. The main configuration file is settings.xml, located in the conf directory of your Maven installation. You can also create a user-specific settings file at ~/.m2/settings.xml.

Setting JAVA_HOME Environment Variable

Maven relies on the JAVA_HOME environment variable to find the Java runtime. If you haven’t set it already, add it to your shell profile. For bash users, edit ~/.bashrc or ~/.bash_profile:

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

Replace the path with your actual Java installation directory. Apply the changes with source ~/.bashrc.

Configuring Maven Memory Settings

For large projects, you may need to increase Maven’s memory allocation. Edit the MAVEN_OPTS environment variable in your profile:

export MAVEN_OPTS="-Xms512m -Xmx2048m"

This sets the initial heap size to 512 MB and maximum to 2 GB. Adjust these values based on your system’s available memory.

Verifying Maven Installation

After installation, run a quick test to ensure everything works correctly. Create a simple Maven project using the archetype plugin:

mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

This command generates a basic Java project structure. Navigate into the project directory and build it:

cd my-app
mvn package

If the build succeeds, you will see a BUILD SUCCESS message. The compiled JAR file will be in the target directory. This confirms that Maven is installed and working correctly.

Common Installation Issues And Fixes

Sometimes the installation process encounters problems. Here are some frequent issues and their solutions:

  • Java not found: Ensure JAVA_HOME is set correctly. Run echo $JAVA_HOME to verify.
  • Permission denied: When extracting tarballs, use sudo if necessary. For user-specific installations, extract to your home directory.
  • Command not found: After setting environment variables, restart your terminal or run source on the profile file.
  • Version mismatch: If you installed multiple versions, check which mvn command is being used with which mvn.
  • Proxy issues: If behind a corporate proxy, configure proxy settings in settings.xml under the section.

Uninstalling Maven

If you need to remove Maven, the method depends on how you installed it. For APT installations, use:

sudo apt remove maven

For manual tarball installations, simply delete the extraction directory and remove the symbolic link:

sudo rm -rf /opt/apache-maven-3.9.6 /opt/maven
sudo rm /etc/profile.d/maven.sh

For snap installations, use:

sudo snap remove maven

After uninstalling, remove any Maven-related environment variables from your shell profile to avoid conflicts.

Frequently Asked Questions

Do I Need Root Access To Install Maven On Linux?

Not necessarily. You can install Maven in your home directory without root privileges. Simply download the tarball, extract it to ~/maven, and update your PATH variable accordingly. However, system-wide installations typically require sudo.

What Is The Difference Between Maven And Gradle?

Both are build automation tools, but Maven uses XML for configuration while Gradle uses Groovy or Kotlin DSL. Maven follows a convention-over-configuration approach, making it easier for beginners. Gradle offers better performance for large projects through incremental builds.

Can I Install Multiple Versions Of Maven On The Same System?

Yes, you can have multiple Maven versions installed simultaneously. Simply extract each version to a different directory and switch between them by changing your PATH variable. Some developers use version managers like SDKMAN to handle multiple versions easily.

How Do I Update Maven To The Latest Version?

For APT installations, use sudo apt update && sudo apt upgrade maven. For manual installations, download the new tarball, extract it, and update the symbolic link to point to the new version. Snap installations update automatically.

Why Does Maven Fail With “Java Home Is Not Set” Error?

This error occurs when the JAVA_HOME environment variable is not set or points to an incorrect location. Verify your Java installation path and set JAVA_HOME in your shell profile. On some systems, you may also need to install the JDK instead of just the JRE.

Conclusion

You now know exactly how to install Maven in Linux using multiple methods. Whether you choose the simple APT approach, the flexible tarball method, or the convenient snap package, Maven will be ready for your Java development projects. Remember to verify the installation with a test project and configure environment variables for seamless usage.

Maven is an essential tool for Java developers, and having it properly installed streamlines your build process. With the steps outlined in this guide, you can set up Maven on any Linux distribution quickly. If you encounter any issues, refer to the common fixes section or consult the official Apache Maven documentation for more detailed troubleshooting.