Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time


Contributing to Apache Maven Surefire

ASF Jira Maven Central Apache License, Version 2.0, January 2004

CI Jenkins Status Jenkins tests Jenkins JaCoCo


The Maven Community

slack forks

Project Documentation

Maven 3.0 Plugin API

Usage of maven-surefire-plugin, maven-failsafe-plugin, maven-surefire-report-plugin

Development Information

Build the Surefire project using Maven 3.2.5+ and JDK 1.8+.

  • In order to run tests for a release check during the Vote, the following memory requirements are needed:

    On Linux/Unix:

    export MAVEN_OPTS="-server -Xmx512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+TieredCompilation -XX:TieredStopAtLevel=1 -XX:SoftRefLRUPolicyMSPerMB=50 -Djava.awt.headless=true"

    On Windows:

    set MAVEN_OPTS="-server -Xmx256m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+TieredCompilation -XX:TieredStopAtLevel=1 -XX:SoftRefLRUPolicyMSPerMB=50 -Djava.awt.headless=true"
  • In order to build and run the tests:

    mvn install site site:stage -P reporting,run-its
  • To set up the project in Eclipse IDE or IntelliJ IDEA, please follow these steps:

    • Build module surefire-shared-utils with profile ide-development and install it into the local maven repository using this Maven command:

      mvn install -P ide-development -f surefire-shared-utils/pom.xml
    • Build module surefire-grouper in order to generate and compile sources into target/generated-sources/javacc using this Maven command:

      mvn compile -f surefire-grouper/pom.xml
    • In Eclipse, select File > Import ... > Maven Project

      • Select all projects (poms) except surefire-shared-utils, enter profile ide-development in Advanced -> Profiles
      • Check module surefire-grouper has source folder target/generated-sources/javacc. If not, add it manually in the module's project properties
    • In IntelliJ, select Maven > Profiles and check ide-development

Deploying web site


Built with Maven