--- schema_version: "1" id: cde8a3f520aa77ddb9705cf6575299de55634bf9bc8aa8ff1ae595ae739778ef title: Hardware and Software Requirements for On-Premises Mule Runtime Engine collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/on-premises/4.12/hardware-and-software-requirements.md canonical_url: https://docs.mulesoft.com/on-premises/4.12/hardware-and-software-requirements source_site: docs.mulesoft.com content_type: documentation content_hash: b6c6b70bfa750b9890e846d2bb61c0c4b0399f92d34e498f852adb359e39cb75 description: MuleSoft Documentation Site release: "4.12" latest: false --- --- product: On-premises Runtimes version: 4.12 keywords: RHEL, Red Hat, Rocky Linux, Ubuntu, Windows Server, supported versions, sizing, RAM, heap, CPU, on-premises, on-prem, standalone, JDK 17 --- # Hardware and Software Requirements for On-Premises Mule Runtime Engine > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Confirm these requirements before you download on-premises runtime. This is the Prerequisites stage in [On-Premises Runtimes Overview](https://docs.mulesoft.com/on-premises/4.12/). After the host meets them, download Mule Enterprise Edition. See [Download, Install, Configure, and Upgrade On-Premises Mule Runtime Engine](https://docs.mulesoft.com/on-premises/4.12/runtime-installation-task). ## Review Minimum Hardware Requirements The CloudHub vCore sizing model doesn’t apply to on-premises runtime. You size CPU, heap, and RAM on the host yourself. - 2 GHz CPU or 1 virtual CPU in virtualized environments. - 1 GB of RAM. - 4 GB of storage. Adjust RAM to match your latency requirements and the size and number of simultaneous messages that Mule applications process. Mule runtime engine supports the x86 and x64 architectures. On-premises runtime isn’t supported on ARM processors. ## Use a Supported Java Version Verify that you use a supported version of Java before you install Mule runtime engine. Mule runtime engine requires JDK 17.
SoftwareVersion

JDK

JDK 17

> [!NOTE] Though you can run a different JDK of choice, MuleSoft doesn’t support or take action to > fix issues if they’re traced back to the JDK. ## Review Supported Operating Systems Mule runtime engine is supported on any operating system that runs a Java Runtime Environment (JRE) from a supported JDK. Red Hat Enterprise Linux (RHEL) is a tested distribution. MuleSoft supports RHEL clones such as Rocky Linux even when a specific clone version isn’t listed as tested. ### Review Tested Software Mule runtime engine passed functional testing against these software and operating systems:
SoftwareVersion

OS

MacOS 10.15, Windows Server 2019, Windows 10, Red Hat Enterprise Linux 9.4, Ubuntu Server 20.04

JDK

Adoptium OpenJDK distribution

This Mule version bundles the Runtime Manager agent plugin version 2.7.14. You need that agent only if you register the instance with Anypoint Runtime Manager. That registered model is a [Hybrid Standalone Runtime](https://docs.mulesoft.com/hybrid-standalone/), not unregistered on-premises runtime. For agent compatibility, see [Runtime Manager Agent Release Notes](https://docs.mulesoft.com/release-notes/runtime-manager-agent/runtime-manager-agent-release-notes). ## Troubleshoot Common Error Messages ### `Unsupported class file major version 61` This error means bytecode compiled for Java 17 (class file major version 61) was loaded by an older JDK, or Mule runtime engine is running on an unsupported JDK. Mule runtime engine requires JDK 17. ### `JavaVersionNotSupportedByExtensionException` An extension, connector, or module such as APIkit doesn’t support the JDK that on-premises runtime is running. Mule runtime engine requires JDK 17. Align the Mule application’s Java compatibility with that JDK, or run a JDK the extension lists as supported. ### `OutOfMemoryError: Metaspace` The JVM that hosts on-premises runtime ran out of Metaspace. Increase Metaspace in the Java Service Wrapper (`wrapper.conf`) rather than only increasing heap. Heap and Metaspace are separate pools. See [Configure JVM Memory and Wrapper Timeouts](https://docs.mulesoft.com/on-premises/4.12/runtime-installation-task#configure-jvm-memory-and-wrapper-timeouts). ## See Also - [On-Premises Runtimes Overview](https://docs.mulesoft.com/on-premises/4.12/) - [Download, Install, Configure, and Upgrade On-Premises Mule Runtime Engine](https://docs.mulesoft.com/on-premises/4.12/runtime-installation-task) - [Java Support](https://docs.mulesoft.com/general/java-support#mule-runtime-java-support) - [Hybrid Standalone Runtimes](https://docs.mulesoft.com/hybrid-standalone/)