Unable to start Keycloak from built quarkus-run.jar (exit code 10) #43593

Foorcee · 2025-10-19T10:47:52Z

Foorcee
Oct 19, 2025

After following #building to build Keycloak from source, the built quarkus-run.jar cannot be started directly using the suggested command:

java -jar quarkus/server/target/lib/quarkus-run.jar start-dev

The process immediately exits with exit code 10 after the Quarkus augmentation step, without providing any explicit error message.

I created a Dockerfile to reproduce this:

FROM maven:3.9.9-eclipse-temurin-21

RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*

WORKDIR /opt
RUN git clone https://github.com/keycloak/keycloak.git
WORKDIR /opt/keycloak

RUN --mount=type=cache,target=/root/.m2 ./mvnw -pl quarkus/deployment,quarkus/dist -am -DskipTests clean install


EXPOSE 8080

ENTRYPOINT ["/bin/sh", "-c", "java -jar quarkus/server/target/lib/quarkus-run.jar start-dev; code=$?; echo Keycloak exited with code $code; exit $code"]

The output:

docker run keycloak-dev              
Updating the configuration and installing your custom providers, if any. Please wait.
2025-10-19 10:35:49,893 INFO  [io.quarkus.deployment.QuarkusAugmentor] (main) Quarkus augmentation completed in 2878ms
Keycloak exited with code 10

Answered by shawkins

Oct 19, 2025

java -jar quarkus/server/target/lib/quarkus-run.jar start-dev

Especially for a developer in an IDE the preferred launch is the org.keycloak.Keycloak class in the keycloak-junit5 module.

That page needs updated as the direct java launch now also requires -Dkc.config.built=true: java -Dkc.config.built=true -jar quarkus/server/target/lib/quarkus-run.jar start-dev

View full answer

shawkins · 2025-10-19T11:35:11Z

shawkins
Oct 19, 2025
Collaborator

java -jar quarkus/server/target/lib/quarkus-run.jar start-dev

Especially for a developer in an IDE the preferred launch is the org.keycloak.Keycloak class in the keycloak-junit5 module.

That page needs updated as the direct java launch now also requires -Dkc.config.built=true: java -Dkc.config.built=true -jar quarkus/server/target/lib/quarkus-run.jar start-dev

1 reply

shawkins Oct 20, 2025
Collaborator

Addressed by #43606

Navigation Menu

Repository navigation

Unable to start Keycloak from built quarkus-run.jar (exit code 10) #43593

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment 1 reply

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Unable to start Keycloak from built quarkus-run.jar (exit code 10) #43593

Uh oh!

Foorcee Oct 19, 2025

Replies: 1 comment · 1 reply

Uh oh!

Uh oh!

shawkins Oct 19, 2025 Collaborator

Uh oh!

shawkins Oct 20, 2025 Collaborator

Foorcee
Oct 19, 2025

Replies: 1 comment 1 reply

shawkins
Oct 19, 2025
Collaborator

shawkins Oct 20, 2025
Collaborator