Keycloak 17.0.0 results in "page not found" for admin url

I have tried the following Docker image and the download zip of version 17.0.0 and I get the same results

On using the URL http://localhost:8080/auth/admin I get a “page not found” message.
Note: this is not https

Here is the log file when the error occurs…

2022-02-17 12:57:52,619 DEBUG [org.keycloak.transaction.JtaTransactionWrapper] (executor-thread-3) new JtaTransactionWrapper
2022-02-17 12:57:52,619 DEBUG [org.keycloak.transaction.JtaTransactionWrapper] (executor-thread-3) was existing? false
2022-02-17 12:57:52,620 DEBUG [] (executor-thread-3) Error response 404: RESTEASY003210: Could not find resource for full path: http://localhost:8080/auth/admin
	at org.jboss.resteasy.core.registry.SegmentNode.match(
	at org.jboss.resteasy.core.registry.RootNode.match(
	at org.jboss.resteasy.core.registry.RootClassNode.match(
	at org.jboss.resteasy.core.ResourceMethodRegistry.getResourceInvoker(
	at org.jboss.resteasy.core.SynchronousDispatcher.getInvoker(
	at org.jboss.resteasy.core.SynchronousDispatcher.lambda$invoke$4(
	at org.jboss.resteasy.core.SynchronousDispatcher.lambda$preprocess$0(
	at org.jboss.resteasy.core.interception.jaxrs.PreMatchContainerRequestContext.filter(
	at org.jboss.resteasy.core.SynchronousDispatcher.preprocess(
	at org.jboss.resteasy.core.SynchronousDispatcher.invoke(
	at io.quarkus.resteasy.runtime.standalone.RequestDispatcher.service(
	at io.quarkus.resteasy.runtime.standalone.VertxRequestHandler.dispatch(
	at io.quarkus.resteasy.runtime.standalone.VertxRequestHandler.handle(
	at io.quarkus.resteasy.runtime.standalone.VertxRequestHandler.handle(
	at io.vertx.ext.web.impl.RouteState.handleContext(
	at io.vertx.ext.web.impl.RoutingContextImplBase.iterateNext(
	at io.quarkus.vertx.http.runtime.StaticResourcesRecorder$2.handle(
	at io.quarkus.vertx.http.runtime.StaticResourcesRecorder$2.handle(
	at io.vertx.ext.web.impl.RouteState.handleContext(
	at io.vertx.ext.web.impl.RoutingContextImplBase.iterateNext(
	at io.quarkus.vertx.http.runtime.VertxHttpRecorder$5.handle(
	at io.quarkus.vertx.http.runtime.VertxHttpRecorder$5.handle(
	at io.vertx.ext.web.impl.RouteState.handleContext(
	at io.vertx.ext.web.impl.RoutingContextImplBase.iterateNext(
	at org.keycloak.quarkus.runtime.integration.web.QuarkusRequestFilter.lambda$createBlockingHandler$1(
	at io.vertx.core.impl.ContextImpl.lambda$null$0(
	at io.vertx.core.impl.AbstractContext.dispatch(
	at io.vertx.core.impl.ContextImpl.lambda$executeBlocking$1(
	at io.quarkus.vertx.core.runtime.VertxCoreRecorder$13.runWith(
	at org.jboss.threads.EnhancedQueueExecutor$
	at org.jboss.threads.EnhancedQueueExecutor$
	at java.base/

2022-02-17 12:57:52,625 DEBUG [freemarker.cache] (executor-thread-3) Couldn't find template in cache for "error.ftl"("en_GB", UTF-8, parsed); will try to load it.
2022-02-17 12:57:52,625 DEBUG [freemarker.cache] (executor-thread-3) TemplateLoader.findTemplateSource("error_en_GB.ftl"): Not found

I have started the service via this command…

./ start-dev --log-level=DEBUG


Any ideas on how to resolve this?


I have just found the following bug raised:

1 Like

The new default path in keycloak 17 is /. You can updated it to the old one with the --hostname-path=/auth flag.


Hi @xgp , after building and starting keycloak with --hostname-path=/auth flag and trying to open the Administration Console, I get redirected to http://localhost:8080/auth/admin/ which returns “Page not found”.

Any idea ?

Send your whole startup command so that I can debug.

After ./ build --http-relative-path=/auth

I tried the below commands:
./ start-dev --http-port=8080 → New base path doesn’t take effect
./ start-dev --http-port=8080 --hostname-admin=/auth → it redirects to Page not found
./ start-dev --http-port=8080 --hostname-path=/auth → it redirects to blank page with errors on browser console
./ start-dev --http-port=8080 --hostname-path=/auth --hostname-admin=/auth → it redirects to blank page with errors on browser console

try putting --http-relative-path=/auth in your start-dev command. AFAIK, running build has no effect on running start-dev. It is only for use before start

It worked :+1:
thank you @xgp

Hi @xgp.

The --http-relative-path=/auth flag is not accepted in production mode.

Any idea ?

The build and start flags have to be used separately. If you look at the guide here Keycloak - Server - All configuration you will see a little tool icon next to --http-relative-path. That means you can either use it with build or start-dev. If you want your production setup to use --http-relative-path, you must first run it in build, and then start will use it.

My understanding is that the goal was to make startup time faster, but I’ve noticed here that how and where to use the configuration options is now a consistent source of confusion.

I understand the building process, before starting the application, no matter the mode I try to start, start-dev (development mode) or start (production mode) I always run build --http-relative-path=/auth

I figured out the problem

I was running ./ start --https-port=8181
It seems that for the frontend app the --https-port is ignored

After running:
./ start --https-port=8181

Now everything is working properly when I try to access the Admin console.

Thanks for your help @xgp

1 Like

Careful when you move to 17.0.1 - that port number after the host name is not supported anymore (apparently it shouldn’t actually work in 17.0.0), so you’ll likely need to make adjustments. Test before upgrading!

Hi @soundsessential, yes it is working fine for me on version 17.0.0.

If get any problem when moving to 17.0.1 I get back here.

Thank you