v4.2.3 Compatibility & Breaking Changes

When installing and upgrading to Morpheus v4.2.3, refer to the following to ensure compatibility.

Breaking Changes

  • 4.2.1: Appliance: OS: Ubuntu 14.04 has reached its end of life (EOL) and is no longer supported as a Morpheus Appliance Host Operating System. Any Morpheus Appliance running on 14.04 must be upgraded to 16.04, 18.04 or 20.04 BEFORE upgrading to 4.2.1+. Upgrades on 14.04 will not succeed
  • 4.2.1: Clouds: VirtualBox, VirtuSteam, and MetaCloud Cloud Types are no longer supported or available
  • 4.2.1: Puppet: Morpheus integration now supports version 6+. Puppet versions prior to 6 are no longer supported
  • 4.2.1: Tasks: Python: Virtual environment are now used for Python Tasks. Note: virtualenv is required on all Appliance App nodes: pip install virtualenv

Morpheus Application OS

Morpheus can be installed on the following platforms. Please note the table below is for Morpheus Application OS support, not Morpheus Agent OS Support.


Existing Morpheus Appliances on 14.04 must upgrade to 16.04 or 18.04 PRIOR to upgrading to v4.2+.

Supported Appliance Operating Systems
OS Version(s) Notes
Amazon Linux 2  
CentOS 7.x, 8.x  
Debian 9, 10 FreeRDP 2.0 is not compatible with Debian 9. Guacd will remain at 1.0.0 for Appliances running on 9.
RHEL 7.x, 8.x  
SUSE SLES 12, 15  
Ubuntu 16.04, 18.04 14.04 is no longer supported for Appliance OS. Existing Appliances on 14.04 must upgrade to 16.04 or 18.04 PRIOR to upgrading to v4.2.1+. Note: 14.04 is still supported by the Morpheus Agent.


v4.2.3 Service Version Changes

No service version changes from 4.2.2-4

v4.2.3 Service Version Compatibility

When externalizing MySQL, Elasticsearch and/or RabbitMQ services, the following versions are compatible with version Morpheus v4.2.3

Service Compatible Branch Morpheus Installer Version
MySQL v5.7 v5.7.29
Percona 5.7, WSREP 31 n/a
Elasticsearch v7.x v7.8.1
RabbitMQ v3.5-3.8 v3.8.5
Tomcat   v9.0.37


Elasticsearch 7.x is required for v4.2.3. Refer to Upgrading section for more information.



Please be aware of the default security enhancements added to v4.1.2+ and assess potential impacts to your environment, including agent installation and frontend load balancers.

  • 4.1.2: Appliance: Starting in v4.1.2, the default Morpheus Nginx config removes support for incoming TLS v1.0 and v1.1 connections. Please update source config to be compatible. If necessary, Morpheus can be configured to support older TLS versions via morpheus.rb config.
  • 4.2.1: Security: Web Security response headers set for enhanced security



Current iterations of Amazon AWS, Microsoft Azure, Google Cloud Platform, Digital Ocean, HPE OneView, OpenTelekom Cloud, IBM Bluemix, Softlayer and UpCloud are all supported.

Integration Supported Version(s) Notes
Ansible 2.7.x  
Ansible Tower 3.3.x  
App Dynamics 4.5.x  
Azure Stack 2002 back to 1908 2019-03-01-hybrid api-profile version used which is supported in 1908 and later Azure Stack versions
Cisco ACI 3.10  
Commvault v11 sp 19  
Jenkins < 2.176.1  
Kubernetes 1.x  
Kubernetes Major:”1”, Minor:”17”, GitVersion:”v1.17.3”  
Microsoft Hyper-V 2012R2, 2016, 2019  
Nutanix AHV 5.0 - 5.10 Note: Prism Central is not a supported endpoint In 5.5 - 5.7 if Prism Central is managing Prism Element, image creation will not function due to PC Image Management.
Openstack Juno, Kilo, Liberty, Mitaka, Newton, Ocata, Pike, Queens, Rocky, Stein, Train  
Rubrik 4.2  
SCVMM 2016, 2019  
ServiceNow Kingston, London, Madrid, New York, Orlando, and Paris  
Splunk 7.10  
Terraform v0.11.x, v0.12.18+ v0.13.x has not been validated
vCloud Director 8.20, 9.1, 9.5, 9.7*, 10.0 *vCD 9.7 supported on API v31
Veeam 9.5u3, 9.5u4, 10  
VMware ESXi 5.5, 6.0, 6.5, 6.7, 7  
VMware Fusion 8, 9, 10+  
VMware NSX -V, -T v3  
VMware vCenter 5.5, 6.0, 6.5, 6.7, 7  
XenServer 7.x  


Non-listed versions may be compatible but are not verified.