{"record":{"id":"192e9101a1cc21d5","repo":"quarkusio/quarkus","slug":"quarkus-gradle-plugins-require-gradle","errorCode":null,"errorMessage":"Quarkus Gradle plugins require Gradle ","messagePattern":"Quarkus Gradle plugins require Gradle ","errorType":"exception","errorClass":"GradleException","httpStatus":null,"severity":"error","filePath":"devtools/gradle/gradle-model/src/main/java/io/quarkus/gradle/GradleVersionSupport.java","lineNumber":23,"sourceCode":"\npublic final class GradleVersionSupport {\n\n    public static final String MINIMUM_GRADLE_VERSION = GeneratedGradleVersionSupport.MINIMUM_GRADLE_VERSION;\n\n    public static final String SUPPORTED_GRADLE_VERSIONS = GeneratedGradleVersionSupport.SUPPORTED_GRADLE_VERSIONS;\n\n    private static final GradleVersion MINIMUM_GRADLE = GradleVersion.version(MINIMUM_GRADLE_VERSION);\n\n    private GradleVersionSupport() {\n    }\n\n    public static void requireMinimumGradleVersion() {\n        requireMinimumGradleVersion(GradleVersion.current());\n    }\n\n    static void requireMinimumGradleVersion(GradleVersion currentVersion) {\n        if (currentVersion.compareTo(MINIMUM_GRADLE) < 0) {\n            throw new GradleException(\"Quarkus Gradle plugins require Gradle \" + MINIMUM_GRADLE_VERSION\n                    + \" or later. Current version is: \" + currentVersion);\n        }\n    }\n}\n","sourceCodeStart":5,"sourceCodeEnd":28,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/devtools/gradle/gradle-model/src/main/java/io/quarkus/gradle/GradleVersionSupport.java#L5-L28","documentation":"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.","triggerScenarios":"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.","commonSituations":"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.","solutions":["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","Update CI/dev containers to a Gradle version meeting the minimum","Check the Quarkus migration guide to see which minimum Gradle version the new Quarkus release requires"],"exampleFix":"// before (gradle/wrapper/gradle-wrapper.properties)\ndistributionUrl=gradle-6.9-bin.zip\n// after\ndistributionUrl=gradle-8.6-bin.zip","handlingStrategy":"validation","validationCode":"import org.gradle.util.GradleVersion\n// in build.gradle or settings.gradle, before applying the plugin\nif (GradleVersion.current().isLessThan(\"8.6\")) {\n    throw new GradleException(\"Upgrade Gradle: Quarkus requires 8.6+; current is ${GradleVersion.current().version}\")\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Pin the Gradle wrapper in version control and update it deliberately","Check Quarkus release notes for raised minimum Gradle versions before upgrading","Keep CI images' Gradle in sync with the wrapper","Use ./gradlew wrapper --gradle-version to upgrade consistently"],"tags":["gradle","build-tool","version-check","configuration"],"backgroundTag":"gradle-version-too-old","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}