Introduction / Technical requirements and recommendations / Compatible components

Compatible components for use with FirstSpirit

Table of contents

FirstSpirit is operated successfully by customers and partners with a wide range of different third-party components (operating systems, JDKs, servlet engines, application servers, databases).

The system configurations listed here are / have been checked by Crownpeak and deemed functional.

Information about the test interval: Compatible system configurations are tested by Crownpeak on a regular basis (depending on the market relevance of the configuration). We maintain the necessary infrastructure for common components for this purpose.

Information about troubleshooting: External components that are used in conjunction with FirstSpirit are not part of the FirstSpirit product. The relevant manufacturer (not Crownpeak) is responsible for the functionality provided by these external components.

Problems which arise when using these components in conjunction with FirstSpirit can, however, be reported via FirstSpirit product support at any time. After a detailed error analysis, Crownpeak will take the necessary steps to eliminate the error (or will attempt to find a workaround for the problem).

If, in individual cases, the error cannot be eliminated within FirstSpirit and a workaround cannot be found for the problem, the system configuration will be defined as "Not supported" in future.

The following factors will always help to ensure rapid troubleshooting:

  • The reproducibility of the problem and
  • An ongoing software maintenance contract with a system configuration option (if necessary including remote maintenance access to production and test systems as well as the licensing of third-party products)

FirstSpirit Server

Compatible operating systems

  • Fedora and derivatives in the respective current version
  • Debian und derivatives in the respective current version
  • Microsoft Windows Server in the current version

Important Only operating systems in the 64-bit variant are supported!

Compatible JDKs

  • OpenJDK 21 (in the current version)
  • OpenJDK 17 (reference, in the current version)

Important For FirstSpirit, Crownpeak aims to support the latest LTS version of OpenJDK. However, the recommendation for running both server and client applications is currently OpenJDK 17.

Oracle vs. OpenJDK: To reduce dependency on Oracle's Java development and also so that longer-term plans can be made for the benefit of our customers, Crownpeak will increase its focus on the use of OpenJDK. We plan to test the latest OpenJDK LTS versions regularly for use with FirstSpirit, release them and also designate them as reference versions.

Recommended: Use of the OpenJDK distribution AdoptOpenJDK (HotSpot JVM): AdoptOpenJDK provides up-to-date OpenJDK binaries for different platforms (e.g. macOS, Linux, Windows) for download. For information about AdoptOpenJDK see

Incompatibilities with specific Java versions: FirstSpirit is always released for a main version of a JDK. JDK updates are regularly issued as part of JDK bug fixes. These updates are checked for compatibility with FirstSpirit as part of quality assurance. In very rare cases, bugs in the JDK that cannot be bypassed by programming may cause incompatibilities. These bugs are not related to FirstSpirit. In this case, we recommend switching back to an older JDK version or using a newer JDK version if available. Please contact Technical Support in the event of known problems.

FirstSpirit desktop apps

Compatible operating systems

  • macOS Ventura (13.5) *
  • macOS Monterey (12.4) *
  • macOS Catalina (10.15) *
  • Microsoft Windows 10
  • Ubuntu 22.04 LTS *

* Notes on using macOS and Linux: macOS and Linux are supported but with restrictions: With these two operating systems, only the basic FirstSpirit functions are tested regularly as part of quality assurance – quality assurance continues to focus on Microsoft Windows. Linux in particular has a wide range of interfaces (window managers) which makes it very complicated to perform a full function test. Working regularly with macOS and Linux can therefore lead to more operating-system-related problems than with Microsoft Windows, but these problems are dealt with as far as is technically possible in the context of software maintenance. Due to major differences compared to Windows-based systems (particularly with regard to interface libraries), there are also restrictions in relation to drag-and-drop functions and regarding the integration of native applications, e.g., in the integrated preview.

Important Only operating systems in the 64-bit variant are supported!

Note on the compatibility of FirstSpirit with Apple Silicon:
With the company's own M1 processor, Apple switches to an ARM architecture. Applications that were developed for an x86 architecture (such as FirstSpirit) can still be executed using the “Rosetta 2” emulation technology. It is important to note that the Intel x64 version of Java has to be used.
Crownpeak is currently not aware of any problems when using FirstSpirit with “Rosetta 2”. However, native support of the ARM architecture is currently not planned for FirstSpirit.

FirstSpirit web apps

Compatible browsers

  • Google Chrome
  • Microsoft Edge
  • Mozilla Firefox
  • Apple Safari *

* FirstSpirit works generally with Apple Safari, but there may be functional restrictions that are based on the implementation method of the browser and cannot be circumvented in programming terms (e.g. restricted SVG support).

Compatible application servers

  • Apache Tomcat 10.1 *
  • Apache Tomcat 9.0 *
  • Apache Tomcat 8.5 *

* We strongly recommend using Apache Tomcat version 8.5.51 (or higher) or Apache Tomcat version 9.0.78 (or higher). This is because of security concerns due to critical bugs in previous Apache Tomcat versions. Tomcat 10.1 is mandatory as of FirstSpirit version 2023.9.

Important Servlet API: A servlet engine integrating version 3.0 (Java EE, until 2023.8) or version 6.0 (Jakarta EE, starting with 2023.9) of the servlet API is required in order to use the FirstSpirit web applications. (Although the web applications of the FirstSpirit modules are essentially based on version 3.0 or 6.0, certain module features may deviate from this.)
Important The open-source product “Eclipse Jetty” which is provided with FirstSpirit is not suitable for live operation and should only be used for test purposes.
It is not supported for operation with “FirstSpirit Content Experience Tools” (CXT).


Compatible database systems

  • IBM DB2 10.5
  • IBM DB2 9.5+
  • MariaDB 10.1
  • MySQL 5.6 (Linux and Windows)
  • MySQL 5.5 (Linux and Windows)
  • Microsoft SQL Server 2016 (only for Windows Server)
  • Microsoft SQL Server 2014 (only for Windows Server)
  • Microsoft SQL Server 2012 (only for Windows Server)
  • Microsoft SQL Server 2008 (only for Windows Server)
  • Oracle 19c (Linux and Windows)
  • Oracle 12c (Linux and Windows)
  • Oracle 11g R2 (Linux and Windows)
  • PostgreSQL 14.x (Linux and Windows)
  • PostgreSQL 13.x (Linux and Windows)
  • PostgreSQL 12.x (Linux and Windows)
  • PostgreSQL 11.x (Linux and Windows)
  • PostgreSQL 10.x (Linux and Windows)

Important The integrated Apache Derby database is not suitable for live operation and should only be used for tests.

© 2005 - 2023 Crownpeak Technology GmbH | All rights reserved. | FirstSpirit 2023.13 | Data privacy