Certified stack

The following software components have passed Magnolia’s certification testing for compatibility and performance with Magnolia DX Core and the Apache Jackrabbit Java Content Repository. Other components have been demonstrated to work in client environments though they may not have been tested for certification by Magnolia.

Operating Systems

  • Linux distributions

  • Windows

  • Other

The distribution must be running kernel 2.6 and higher.

  • Ubuntu - all currently supported LTS releases.

  • SuSE Linux Enterprise Server - all releases with existing (SuSE) general support.

  • Fedora - latest two releases.

  • Red Hat Enterprise Linux Server

    • For Magnolia 6.2.x: RHEL 7 (and higher) with full support or maintenance support.

  • CentOS 6 and 7

  • Debian - all currently supported LTS releases.

  • Windows Server

    • 2012 R2

    • 2019 Standard or Datacenter

  • Windows 10

  • macOS 10.15 and higher

Are you running Magnolia on an OS that is not listed here? Let us know by posting to the forum and mailing lists.

Container OS

The latest version of the 9.0-jre11-temurin image has been verified for the Certified Stack information found on this page.

Java

You need a Java Development Kit (JDK) or a Java Runtime Environment (JRE) on your system to run Magnolia and either the Tomcat application server that ships with the bundle or a Java EE 8 / Jakarta EE 8 compliant server.

JRE is an implementation of the Java Virtual Machine which executes Java programs. JDK is a bundle of software that you can use to develop Java based applications. If you plan to write your own Java code get the JDK. If you just want to run Magnolia then JRE is sufficient.

Magnolia releases run on the active Java version at the time of the first release.

Java version Magnolia

Java 21 (LTS)

Magnolia 6.2.45+


Magnolia runs on Java 21 JVMs, but requires classes to be compiled at most with JDK 17, due to the version of the ASM library shipped with the product.

Java 17 (LTS)

Magnolia 6.2.9+


Using @Cacheable annotations?


From Magnolia 6.2.9 to Magnolia 6.2.36, modules using the @Cacheable annotation from addon-commons (info.magnolia.addon.commons.cache.annotation.Cacheable) did not work with Java 17.

  • 6.2.37+

  • 6.2.9 to 6.2.36

Java 11 (LTS)

Minimum supported version for DX Cloud.

Java 8 (LTS)

Magnolia 6.2+

The JavaScript Models module 1.2 will not work with Java 16 as it relies on the Nashorn JavaScript engine, which was deprecated in JDK 11 and removed in JDK 15.

For usage with JDK 11 and higher, please use Javascript Models 2.x, which uses GraalVM.

Oracle JDK and OpenJDK are interchangeable alternatives. Use whichever one you feel more comfortable with. However, please be aware that as of January 2019, Oracle stopped contributing to the OpenJDK 8 Updates project.

Together with OpenJDK 11, the OpenJDK 8 project is maintained by RedHat. For more details, see Leadership of OpenJDK 8 and OpenJDK 11 Transitions to Red Hat.

If you are using AdoptOpenJDK on macOS 10.15, be aware that this build of OpenJDK is currently facing a segmentation fault problem issued as https://github.com/AdoptOpenJDK/openjdk-build/issues/1315, which also affects our Periscope module. Until the issue is fixed in the AdoptOpenJDK project, you can bypass it by excluding the magnolia-periscope-result-ranker artifact from your instances, temporarily losing the functionality the result ranker provides.

Application servers

This section shows the application servers which we have certified (systematically tested per release) as well as those that are supported but not certified.

All application servers listed here fall under our SLA, meaning we support any issues you encounter with the application servers.

The following servers are not certified, only supported. We provide support for them if you use them, but we do not proactively test them for major or maintenance releases of Magnolia.

  • Wildfly 11 and higher

  • JBoss EAP 7.0 and higher

  • IBM WebSphere Application Server 9 and higher

  • IBM WebSphere Liberty 18.0.0.3 and higher

IBM WebSphere is supported only with DX Core and with the special Magnolia package for IBM WebSphere.

Browsers

Back-end: Admincentral and content management

  • Admincentral works in all modern browsers not older than 2 years.

  • Admincentral works with three responsive viewports:

    • Width smaller than 1200px for small screens & tablets

    • Width between 1200px and 1600px for desktop screens

    • Width of more than 1600px for wide screens.

Responsive viewports

Front end: sites built with Magnolia Templating Essentials

Magnolia Templating Essentials (MTE) supports all CSS3/HTML5 compatible browsers.

Cloud: Transport Layer Security (TLS)

For all Magnolia cloud deployments, TLS v 1.2 is the minimal requirement that browsers need to support for both the AdminCentral and all client websites to ensure maximum security.

Databases

Type Database Support notes

Embedded

H2 1.4.200 and higher

We do not recommend using the H2 database for production environments.

Derby 10.14.2.0 (packaged versions)

Apache Derby 10.14.2.0 is only supported as an embedded database in a packaged version for low-volume use only.

External

MySQL 5.5 and higher

InnoDB storage engine for MySQL is supported by Magnolia, MyISAM is not. InnoDB is the default in MySQL 5.5 and higher.

Oracle Enterprise DB

Unless otherwise noted, all vendor-supported database versions are supported for Magnolia.

PostgreSQL

Unless otherwise noted, all vendor-supported database versions are supported for Magnolia.

See PostgreSQL: Versioning support for more details.

Repositories

  • Apache Jackrabbit 2.20.13 (in Magnolia CMS 6.2.52)

Summary

The stack can be summarized as follows:

Tomcat (certified and recommended) JBoss/WildFly (supported) IBM WebSphere (supported)

Linux distributions

Windows

macOS 10.15 and higher

-

Feedback

DX Core

×

Location

This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules