This is an automated email from the ASF dual-hosted git repository.
mbuenger pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git
The following commit(s) were added to refs/heads/master by this push:
new eb584bc0 [MNGSITE-439] Add more ways to install
eb584bc0 is described below
commit eb584bc030358a71e86d3743f710d0b01a5a887f
Author: Björn Raupach <raup...@icloud.com>
AuthorDate: Sun Mar 16 20:28:41 2025 +0100
[MNGSITE-439] Add more ways to install
Updated installation article
- changed required Java version to Java 8
- added several distribution tools which support installation of Maven
---
content/markdown/install.md.vm | 100 ++++++++++++++++++++++++++++++++++-------
content/site.xml | 2 +-
2 files changed, 85 insertions(+), 17 deletions(-)
diff --git a/content/markdown/install.md.vm b/content/markdown/install.md.vm
index 7e003d4a..d80ea90e 100644
--- a/content/markdown/install.md.vm
+++ b/content/markdown/install.md.vm
@@ -1,4 +1,3 @@
-# Installing Apache Maven
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
@@ -17,29 +16,35 @@ KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
-The installation of Apache Maven is a simple process of extracting the archive
-and adding the `bin` directory with the `mvn` command to the `PATH`.
+# Installation
-Detailed steps are:
+Apache Maven can be installed by most package managers,
+or manually by downloading the archive and adding it to your path.
-* Have a JDK installation on your system. Either set the `JAVA_HOME`
environment variable pointing to your JDK installation or have the `java`
executable on your `PATH`.
+#[[##]]# Prerequisites
-* Extract distribution archive in any directory
+You need a Java Development Kit (JDK) installed. Either set the `JAVA_HOME`
+environment variable to the path of your JDK installation or have the `java`
executable
+on your `PATH`.
-```cmd
-unzip apache-maven-${currentStableVersion}-bin.zip
-```
-or
-```sh
-tar xzvf apache-maven-${currentStableVersion}-bin.tar.gz
-```
+The current stable version `${currentStableVersion}` requires JDK 8+, but any
recent version will work just fine.
+
+#[[##]]# Binary distribution
+
+To install Apache Maven, extract the archive and add its bin directory to the
`PATH`.
+This works on any operating system, but setting the path and environment
variables depends on the OS.
+
+Detailed steps are:
+
+1. Download the Apache Maven [binary distribution archive](/download.html).
-Alternatively use your preferred archive extraction tool.
+2. Extract the distribution archive in any directory. Use `unzip
apache-maven-${currentStableVersion}-bin.zip`
+or `tar xzvf apache-maven-${currentStableVersion}-bin.tar.gz` depending on the
archive.
-* Add the `bin` directory of the created directory
`apache-maven-${currentStableVersion}` to
+3. Add the `bin` directory of the created directory
`apache-maven-${currentStableVersion}` to
the `PATH` environment variable
-* Confirm with `mvn -v` in a new shell. The result should look similar to
+4. Confirm with `mvn -v` in a new shell. The result should look similar to:
```
Apache Maven ${currentStableVersion} (${currentStableVersionDetails})
@@ -50,3 +55,66 @@ Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "10.8.5", arch: "x86_64", family: "mac"
```
+That’s it! Maven is now installed.
+
+#[[##]]# macOS
+
+Installation on macOS is supported by [Homebrew](https://brew.sh),
+[SDKMAN!](https://sdkman.io) and
+[MacPorts](https://www.macports.org).
+
+#[[###]]# Homebrew
+
+```
+brew install maven
+```
+
+#[[###]]# SDKMAN!
+
+```
+sdk install maven
+```
+
+#[[###]]# MacPorts
+
+```
+sudo port install maven3
+```
+
+#[[##]]# Linux
+
+The commands depend on the package manager of the Linux Distribution of your
choice.
+
+#[[###]]# APT
+
+```
+sudo apt install maven
+```
+
+#[[###]]# DNF
+
+```
+sudo dnf install maven
+```
+
+#[[###]]# YUM
+
+```
+sudo yum install maven
+```
+
+#[[##]]# Windows
+
+Installation on Windows is supported by [Chocolatey](https://chocolatey.org)
and [Scoop](https://scoop.sh).
+
+#[[###]]# Chocolatey
+
+```
+choco install maven
+```
+
+#[[###]]# Scoop
+
+```
+scoop install main/maven
+```
diff --git a/content/site.xml b/content/site.xml
index ab2814ac..7d0bcc67 100644
--- a/content/site.xml
+++ b/content/site.xml
@@ -44,9 +44,9 @@ under the License.
<menu name="About Maven">
<item name="What is Maven?" href="/what-is-maven.html"/>
<item name="Features" href="/maven-features.html"/>
+ <item name="Installation" href="/install.html" />
<item name="Download" href="/download.html"/>
<item name="Use" href="/users/index.html" collapse="true">
- <item name="Install" href="/install.html"/>
<item name="Run" href="/run.html"/>
<item name="Configure" href="/configure.html"/>
<item name="IDE Integration" href="/ide.html"/>
