{"record":{"id":"9eccc0fbf9857a4c","repo":"quarkusio/quarkus","slug":"this-goal-requires-a-quarkus-extension-registry-cl","errorCode":null,"errorMessage":"This goal requires a Quarkus extension registry client to be enabled","messagePattern":"This goal requires a Quarkus extension registry client to be enabled","errorType":"exception","errorClass":"MojoExecutionException","httpStatus":null,"severity":"error","filePath":"devtools/maven/src/main/java/io/quarkus/maven/QuarkusProjectStateMojoBase.java","lineNumber":53,"sourceCode":"\n    @Component\n    QuarkusWorkspaceProvider workspaceProvider;\n\n    /**\n     * If true, the information will be logged per each relevant module of the project\n     * instead of an overall summary\n     */\n    @Parameter(property = \"perModule\", required = false)\n    boolean perModule;\n\n    @Override\n    public void doExecute(QuarkusProject quarkusProject, MessageWriter log) throws MojoExecutionException {\n        if (project.getFile() == null) {\n            throw new MojoExecutionException(\"This goal requires a project\");\n        }\n\n        if (!QuarkusProjectHelper.isRegistryClientEnabled()) {\n            throw new MojoExecutionException(\"This goal requires a Quarkus extension registry client to be enabled\");\n        }\n\n        final Collection<Path> createdDirs = ensureResolvable(new DefaultArtifact(project.getGroupId(),\n                project.getArtifactId(), ArtifactCoords.TYPE_POM, project.getVersion()));\n        try {\n            processProjectState(quarkusProject);\n        } finally {\n            for (Path p : createdDirs) {\n                IoUtils.recursiveDelete(p);\n            }\n        }\n    }\n\n    protected abstract void processProjectState(QuarkusProject quarkusProject) throws MojoExecutionException;\n\n    protected ApplicationModel resolveApplicationModel() throws MojoExecutionException {\n        try {\n            return new BootstrapAppModelResolver(artifactResolver())","sourceCodeStart":35,"sourceCodeEnd":71,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/devtools/maven/src/main/java/io/quarkus/maven/QuarkusProjectStateMojoBase.java#L35-L71","documentation":"This MojoExecutionException is thrown by QuarkusProjectStateMojoBase.doExecute when QuarkusProjectHelper.isRegistryClientEnabled() returns false. Project-state goals (update, info) require the Quarkus extension registry client to look up available platform/extension versions, and it has been explicitly disabled in the environment. The registry client is disabled via the quarkusRegistryClient user property or registry configuration.","triggerScenarios":"Running mvn quarkus:update (or quarkus:info) with -DquarkusRegistryClient=false, or a settings/config file disabling the registry client.","commonSituations":"CI pipelines carrying a global -DquarkusRegistryClient=false flag inherited from other tooling; users following old docs that advised disabling the client; ~/.quarkus config disabling registries.","solutions":["Remove the -DquarkusRegistryClient=false flag from the Maven command","Remove quarkusRegistryClient=false from ~/.m2/settings.xml or CI configuration","Enable/define extension registries in the Quarkus registry configuration (~/.quarkus/config.yaml) if none exist","If network restrictions prevent registry use, perform updates manually by editing the quarkus.platform.version property in the pom"],"exampleFix":"// before\nmvn io.quarkus:quarkus-maven-plugin:update -DquarkusRegistryClient=false\n// after\nmvn io.quarkus:quarkus-maven-plugin:update","handlingStrategy":"validation","validationCode":"// Ensure the registry client is not disabled before running:\nString flag = System.getProperty(\"quarkusRegistryClient\");\nif (\"false\".equals(flag)) {\n    throw new IllegalStateException(\"quarkusRegistryClient=false; remove it to run quarkus:update\");\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Never set -DquarkusRegistryClient=false globally in CI or .mvn/maven.config","Keep ~/.quarkus/config.yaml registries defined","Audit CI scripts for inherited flags that disable the registry client","Update platform versions manually only when registry access is impossible"],"tags":["maven","registry-client","configuration","cli-usage"],"backgroundTag":"registry-client-disabled","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-12T22:17:10.623Z"}