WebSphere Application Server & Liberty

 View Only

 My applications are failing to start with IBM WAS Liberty 26.0.0.1

Suraj Bellad's profile image
Suraj Bellad posted Mon April 13, 2026 01:05 AM

Hi team,

I need help to know how to address the below issue with Liberty 26.0.0.1 leading to the below errors :

[ERROR   ] CWWKZ0002E: An exception occurred while starting the application config. The exception message was: com.ibm.ws.container.service.metadata.MetaDataException: java.lang.IllegalArgumentException: The headRegion must not be null.

As per my analysis :

IBM WebSphere Liberty 26.0.0.1 enforces strict JSF head region validation. Web application named as D2 classic/config UI templates do not explicitly define a head region, causing Liberty to throw IllegalArgumentException: headRegion must not be null during application startup.

Liberty 26 switched default from:

JSF 2.3  →  Faces 4.0

Faces 4.0 requires <h:head>

 D2 templates are JSF style

As per my understanding, When I check server.xml file, we have jakartaee-10.0 which pulls faces 4.0 but our D2 was built for JSF

Liberty 26 is loading Faces 4 which is breaking D2 UI templates.

We have tried downgrading Spring jars, tested few changes to server.xml file as below :

<featureManager>
<feature>javaee-8.0</feature>
</featureManager>

Instead of <feature>jakartaee-10.0</feature>
we try with <feature>jsf-2.3</feature>


None of these things helped which lead to some other exception and errors with failing to load web application with latest IBM Liberty. 
Please note, it was working with all other older versions.

Attaching our server.xml file and logs for information.

Looking for immedicate help to resolve this issue. Can anyone who has faced similar issue help me point out how to resolve it. 
Thanks in advance!