quarkusio/quarkus · error · MojoExecutionException

This goal requires a Quarkus extension registry client to be

Error message

This goal requires a Quarkus extension registry client to be enabled

What it means

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.

Source

Thrown at devtools/maven/src/main/java/io/quarkus/maven/QuarkusProjectStateMojoBase.java:53

    @Component
    QuarkusWorkspaceProvider workspaceProvider;

    /**
     * If true, the information will be logged per each relevant module of the project
     * instead of an overall summary
     */
    @Parameter(property = "perModule", required = false)
    boolean perModule;

    @Override
    public void doExecute(QuarkusProject quarkusProject, MessageWriter log) throws MojoExecutionException {
        if (project.getFile() == null) {
            throw new MojoExecutionException("This goal requires a project");
        }

        if (!QuarkusProjectHelper.isRegistryClientEnabled()) {
            throw new MojoExecutionException("This goal requires a Quarkus extension registry client to be enabled");
        }

        final Collection<Path> createdDirs = ensureResolvable(new DefaultArtifact(project.getGroupId(),
                project.getArtifactId(), ArtifactCoords.TYPE_POM, project.getVersion()));
        try {
            processProjectState(quarkusProject);
        } finally {
            for (Path p : createdDirs) {
                IoUtils.recursiveDelete(p);
            }
        }
    }

    protected abstract void processProjectState(QuarkusProject quarkusProject) throws MojoExecutionException;

    protected ApplicationModel resolveApplicationModel() throws MojoExecutionException {
        try {
            return new BootstrapAppModelResolver(artifactResolver())

View on GitHub (pinned to e1c734241f)

Solutions

1. Remove the -DquarkusRegistryClient=false flag from the Maven command
2. Remove quarkusRegistryClient=false from ~/.m2/settings.xml or CI configuration
3. Enable/define extension registries in the Quarkus registry configuration (~/.quarkus/config.yaml) if none exist
4. If network restrictions prevent registry use, perform updates manually by editing the quarkus.platform.version property in the pom

Example fix

// before
mvn io.quarkus:quarkus-maven-plugin:update -DquarkusRegistryClient=false
// after
mvn io.quarkus:quarkus-maven-plugin:update

// Ensure the registry client is not disabled before running:
String flag = System.getProperty("quarkusRegistryClient");
if ("false".equals(flag)) {
    throw new IllegalStateException("quarkusRegistryClient=false; remove it to run quarkus:update");
}

When it happens

Trigger: Running mvn quarkus:update (or quarkus:info) with -DquarkusRegistryClient=false, or a settings/config file disabling the registry client.

Common situations: 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.

Related errors

• Either the `extension` or `extensions` parameter must be set
• Specifying a stream requires the Quarkus extension registry
• Unsupported format: ${format}
• Cannot specify both class and method name
• The project artifact's extension is '${extension}' while thi

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