mvn

What it does

How to write it

mvn [OPTIONS] PHASE|PLUGIN:GOAL ...

Main parts

Phases

clean

Delete the target/ folder.

compile / test

Compile / run the unit tests.

package

Make the JAR or WAR in target/.

verify

Run integration tests and checks.

install

Copy the artifact to the local repository (~/.m2).

deploy

Upload the artifact to the remote repository (Nexus, Artifactory).

dependency:tree

Show all dependencies.

versions:set -DnewVersion=X

Change the project version.

Most used

Nothing matches this filter.

$ run as a normal user# run as root (or with sudo)

1. 1Build and test

   $mvn -B clean verify

2. 2Make the JAR without running tests (only when tests ran before)

   $mvn -B -DskipTests package
   $ls target/*.jar

3. 3Build in a container, run on a small image

   $cat Dockerfile
   FROM maven:3.9-eclipse-temurin-21 AS build
   WORKDIR /src
   COPY pom.xml .
   RUN mvn -B -ntp dependency:go-offline
   COPY src ./src
   RUN mvn -B -ntp -DskipTests package
   FROM eclipse-temurin:21-jre
   COPY --from=build /src/target/app.jar /app.jar
   USER 1000
   CMD ["java", "-jar", "/app.jar"]

4. 4Upload to Nexus with credentials from settings.xml

   $mvn -B -s ci-settings.xml deploy

5. 5Show the dependency tree

   $mvn dependency:tree -Dincludes=org.apache.logging.log4j

6. 6Build one module of a big project

   $mvn -B -pl services/orders -am package

7. 7Set the release version in CI

   $mvn -B versions:set -DnewVersion=1.4.0 -DgenerateBackupPoms=false

8. 8Use the production profile

   $mvn -B -P prod package

9. 9Faster build on many cores

   $mvn -B -T 1C verify

10. 10Build without internet (all in ~/.m2)

    $mvn -o package

11. 11Check for known vulnerable dependencies (OWASP plugin)

    $mvn -B org.owasp:dependency-check-maven:check -DfailBuildOnCVSS=7

Nothing matches this filter.

Files

pom.xml

The project model.

~/.m2/settings.xml

Repositories, mirrors and credentials.

~/.m2/repository/

The local cache of downloaded artifacts.

Exit codes