[opencms-dev] OpenCms 20 has been released - Jetty hints

[Jochen Graf]

Hi Antonio,

there is very little you need to know about deployment of OpenCms in Jetty.

The list of Jetty modules can be found here [1].

The OpenCms WAR file needs to be manually extracted into a subfolder of 
webapps. E.g. if you have an OpenCms WAR you want to install as root web 
application, you don't just drop ROOT.war into webapps/ but create a 
ROOT folder in webapps/ and unpack the WAR file inside it.

Optional: If you want to control the caching of exported JavaScript and 
CSS resources with Jetty (as it was possible with Tomcat before), you 
can define a special filter in web.xml, see here [2].

Another detail: For the GUI setup wizard to work, the <load-on-startup> 
setting for the OpenCms servlets (normal and error handler) need to be 
changed to -1 in web.xml.

Another detail: when using the OpenCms Shell, e.g. for headless 
installation, unlike with Tomcat, you should not include the entire 
/lib/ directory in the class path, but only “jetty-servlet-api*.jar”.

Many Apache/Tomcat configurations are likely to remain relevant [3]. 
Since we do not use Apache at Alkacon, we do not yet have any detailed 
information though, particularly regarding AJP.

Hope this helps

Jochen

[1] 
https://github.com/alkacon/opencms-docker/blob/master/image/resources/root/preinit/07_jetty_setup.sh
[2] 
https://github.com/alkacon/opencms-docker/blob/master/image/resources/root/jetty-webxml.xsl
[3] 
https://documentation.opencms.org/opencms-documentation/server-administration/apache-proxy-configuration


Am 16.10.25 um 14:28 schrieb Antonio Cordeddu via opencms-dev:
> Thank you to Alkacon staff for this new release.
>
> From version 17 the web applications suggested are Tomcat and Jetty; 
> could you please give some hints for installation on Jetty?
>
> For example: Jetty modules to enable, configuration with Apache, ...
>
> Kind regards
> Antonio Cordeddu
>
>
> On 14/10/2025 11:10, Alex Kandzior via opencms-dev wrote:
>> Dear OpenCms Users,
>>
>> OpenCms 20 is now available for download!
>>
>> OpenCms 20 adds support for "online only" folders, where content is 
>> automatically published immediately after any modification. The new 
>> link finisher option unifies links to the same page written with 
>> different endings (e.g., /folder/ vs. /folder/index.html). The 
>> combined disk space used by all resources in a folder is now 
>> calculated and displayed. Support has been added for an upload 
>> whitelist to configure which file types are allowed in the upload 
>> dialog. External links in WYSIWYG fields can now automatically 
>> receive a special CSS class. When a detail page is moved to another 
>> folder or site, its associated detail containers are now moved as well.
>>
>> We have also updated the OpenCms Docker image as well as the OpenCms 
>> documentation, the Mercury Template documentation and the OpenCms 
>> demo site for this release.
>>
>> The Mercury Template documentation is now available in both German 
>> and English, providing international developers and users with direct 
>> access to all essential information.
>>
>> Full release notes and download option here:
>> https://www.opencms.org/en/article/OpenCms-20
>>
>> Description of the new features in the Mercury template:
>> https://mercury-template.opencms.org/en/news/version/20
>>
>> The updated Docker image for this release is available at:
>> https://registry.hub.docker.com/r/alkacon/opencms-docker
>>
>> Thanks to everyone who has contributed to this release of OpenCms.
>>
>> Kind regards,
>> Alex.
>>
>> -------------------
>> Alexander Kandzior
>>
>> Alkacon Software - TheOpenCms Experts
>> http://www.alkacon.com -http://www.opencms.org
>>
>>
>>
>> _______________________________________________
>> This mail is sent to you from the opencms-dev mailing list
>> To change your list options, or to unsubscribe from the list, please visit
>> https://lists.opencms.org/mailman/listinfo/opencms-dev
>>
>>
>>
>
> -- 
> _______________________________________________
> Coranto informatica di Antonio Cordeddu
> Via Torricelli, 9 09047 Selargius (CA) - Italy
> Phone: +39 070 8607521
> Fax: +39 070 8607521
> Mobile: +39 328 7552662
> antoniocordeddu at coranto.it
> https://www.coranto.it
> _______________________________________________
>
> Dichiarazione di riservatezza: tutte le informazioni incluse in questa comunicazione sono destinate esclusivamente alla consegna e all'uso autorizzato da parte del destinatario identificato sopra.
> Se Lei non è il destinatario previsto, tenga presente che qualsiasi uso, distribuzione o copia di questa comunicazione non è autorizzato e potrebbe essere illegale.
> Se ha ricevuto questa comunicazione per errore, La preghiamo di avvisare immediatamente il mittente ed eliminare il presente messaggio.
>
> Confidentiality Notice: All information included in this communication is intended solely for delivery and authorized use by the recipient identified above.
> If you are not the intended recipient, please note that any use, distribution, or copying of this communication is not authorized and may be illegal.
> If you have received this communication in error, please notify the sender immediately and delete this message.
>
> _______________________________________________
> This mail is sent to you from the opencms-dev mailing list
> To change your list options, or to unsubscribe from the list, please visit
> https://lists.opencms.org/mailman/listinfo/opencms-dev
>
>
>
-- 
Alkacon Software GmbH & Co. KG  - The OpenCms Experts
http://www.alkacon.com -http://www.opencms.org
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.opencms.org/pipermail/opencms-dev/attachments/20251017/db70cf74/attachment.htm>