quarkusio/quarkus · error · GradleException

Quarkus Gradle plugins require Gradle

Error message

Quarkus Gradle plugins require Gradle 

What it means

Quarkus's Gradle plugins refuse to run on Gradle versions older than the supported minimum. During plugin application, GradleVersionSupport.requireMinimumGradleVersion compares the running Gradle version against MINIMUM_GRADLE and throws a GradleException that halts the build. This keeps builds on Gradle versions whose APIs Quarkus actually supports.

Source

Thrown at devtools/gradle/gradle-model/src/main/java/io/quarkus/gradle/GradleVersionSupport.java:23

public final class GradleVersionSupport {

    public static final String MINIMUM_GRADLE_VERSION = GeneratedGradleVersionSupport.MINIMUM_GRADLE_VERSION;

    public static final String SUPPORTED_GRADLE_VERSIONS = GeneratedGradleVersionSupport.SUPPORTED_GRADLE_VERSIONS;

    private static final GradleVersion MINIMUM_GRADLE = GradleVersion.version(MINIMUM_GRADLE_VERSION);

    private GradleVersionSupport() {
    }

    public static void requireMinimumGradleVersion() {
        requireMinimumGradleVersion(GradleVersion.current());
    }

    static void requireMinimumGradleVersion(GradleVersion currentVersion) {
        if (currentVersion.compareTo(MINIMUM_GRADLE) < 0) {
            throw new GradleException("Quarkus Gradle plugins require Gradle " + MINIMUM_GRADLE_VERSION
                    + " or later. Current version is: " + currentVersion);
        }
    }
}

View on GitHub (pinned to e1c734241f)

Solutions

1. Run ./gradlew wrapper --gradle-version <latest-supported> or edit gradle/wrapper/gradle-wrapper.properties distributionUrl to a Gradle version >= the minimum stated in the message
2. Update CI/dev containers to a Gradle version meeting the minimum
3. Check the Quarkus migration guide to see which minimum Gradle version the new Quarkus release requires

Example fix

// before (gradle/wrapper/gradle-wrapper.properties)
distributionUrl=gradle-6.9-bin.zip
// after
distributionUrl=gradle-8.6-bin.zip

import org.gradle.util.GradleVersion
// in build.gradle or settings.gradle, before applying the plugin
if (GradleVersion.current().isLessThan("8.6")) {
    throw new GradleException("Upgrade Gradle: Quarkus requires 8.6+; current is ${GradleVersion.current().version}")
}

When it happens

Trigger: Applying any Quarkus Gradle plugin (io.quarkus) in a project whose Gradle wrapper version is below MINIMUM_GRADLE; the check runs as soon as the plugin is applied.

Common situations: Cloning an old project with a stale gradle-wrapper.properties; CI images with a system Gradle older than required; upgrading Quarkus (which raises its minimum Gradle) without upgrading the wrapper.

Related errors

• No platforms detected in the project
• Mixed DSL is not supported. Both build and settings file nee
• Malformed URL: + url
• Failed to run application
• Failed to parse removed resource '

AI-assisted analysis of quarkusio/quarkus@e1c734241f (2026-09-05). Data as JSON: /api/errors/192e9101a1cc21d5. Report an issue: GitHub.