Receiving a "Failed to process template" error message when deploying a new theme pack in Red Hat Single Sign-On (RH SSO)

Solution Verified - Updated -


We have a new theme pack which we wanted to deploy in RH SSO. However, it doesn't work and the following error message is displayed in the logs:

16:45:51,816 ERROR [] (default task-1) Uncaught server error: org.keycloak.theme.FreeMarkerException: Failed to process template <TEMPLATE>.ftl
    at org.keycloak.keycloak-services@18.0.3.redhat-00002//org.keycloak.theme.FreeMarkerUtil.processTemplate(
    at org.keycloak.keycloak-services@18.0.3.redhat-00002//
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(
    at java.base/java.lang.reflect.Method.invoke(


Caused by: freemarker.template.TemplateNotFoundException: Template not found for name "<TEMPLATE>.ftl".
The name was interpreted by this TemplateLoader: org.keycloak.theme.FreeMarkerUtil$ThemeTemplateLoader@3776b28e.
    at org.freemarker@2.3.31//freemarker.template.Configuration.getTemplate(
    at org.freemarker@2.3.31//freemarker.template.Configuration.getTemplate(
    at org.keycloak.keycloak-services@18.0.3.redhat-00002//org.keycloak.theme.FreeMarkerUtil.getTemplate(
    at org.keycloak.keycloak-services@18.0.3.redhat-00002//org.keycloak.theme.FreeMarkerUtil.processTemplate(
    ... 77 more


  • Red Hat Single Sign-On (RH SSO)
    • 7.X

Subscriber exclusive content

A Red Hat subscription provides unlimited access to our knowledgebase, tools, and much more.

Current Customers and Partners

Log in for full access

Log In

New to Red Hat?

Learn more about Red Hat subscriptions

Using a Red Hat product through a public cloud?

How to access this content