Installing on IBM watsonx Orchestrate On-premises
Learn how to install IBM watsonx Orchestrate on-premises for both IBM Cloud Pak for Data and IBM Software Hub environments. This guide provides version-specific instructions and compatibility matrices to ensure a smooth deployment.
Installing IBM watsonx Orchestrate for IBM Software Hub
IBM Software Hub is a cloud-native platform designed to simplify the deployment, management, and monitoring of IBM solutions on Red Hat OpenShift. It includes a centralized management interface, called IBM Software Hub Control Center that allows you to manage multiple instances within a single cluster. The integrated web client enables seamless navigation across installed solutions.
The installation steps vary depending on the version of IBM watsonx Orchestrate and the corresponding IBM Software Hub version. Use the table below to find the right guide for your setup:
| Version | Cluster | Installation instructions |
|---|---|---|
| 5.3.0 | IBM Software Hub 5.3.0 | Installing 5.3.0  |
| 5.2.2 | IBM Software Hub 5.2.x | Installing 5.2.2 |
| 5.2.1 | IBM Software Hub 5.2.x | Installing 5.2.1 |
| 5.2.0 (30 July 2025 release) | IBM Software Hub 5.2.x | Installing 5.2.0 |
| 5.2.0 (30 June 2025 release) | IBM Software Hub 5.2.x | Installing 5.2.0 |
| 5.1.3 | IBM Software Hub 5.1.x | Installing 5.1.3 |
| 5.1.2 | IBM Software Hub 5.1.x | Installing 5.1.2 |
| 5.1.1 | IBM Software Hub 5.1.x | Installing 5.1.1 |
| 5.1.0 | IBM Software Hub 5.1.x | Installing 5.1.0 |
Support matrix for IBM Software Hub
Ensure compatibility between your IBM watsonx Orchestrate version, IBM Software Hub, and Red Hat OpenShift:
| watsonx Orchestrate version | IBM Software Hub version | Red Hat OpenShift version |
|---|---|---|
| 5.3.0 | 5.3.x | 4.14, 4.16, 4.17, 4.18, 4.19 or 4.20 |
| 5.2.2 | 5.2.x | 4.12, 4.14, 4.15, 4.16, 4.17, 4.18 or 4.19 |
| 5.2.1 | 5.2.x | 4.12, 4.14, 4.15, 4.16, 4.17, or 4.18 |
| 5.2.0 | 5.2.x | 4.12, 4.14, 4.15, 4.16, 4.17, or 4.18 |
| 5.1.3 | 5.1.x | 4.12, 4.14, 4.15, 4.16, 4.17, or 4.18 |
| 5.1.2 | 5.1.x | 4.12, 4.14, 4.15, 4.16, or 4.17 |
| 5.1.1 | 5.1.x | 4.12, 4.14, 4.15, 4.16, or 4.17 |
| 5.1.0 | 5.1.x | 4.12, 4.14, 4.15, 4.16, or 4.17 |
Installing IBM watsonx Orchestrate for IBM Cloud Pak for Data
IBM Cloud Pak for Data is a Kubernetes based container platform that supports the modernization and automation of data and AI workloads. It enables deployment on your own infrastructure, helping reduce risk and improve data governance.
Choose the appropriate installation guide based on your version of IBM watsonx Orchestrate and IBM Cloud Pak for Data:
| Version | Cluster | Installation instructions |
|---|---|---|
| 5.0.3 | IBM Cloud Pak for Data 5.0.x | Installing 5.0.3 |
| 5.0.1 | IBM Cloud Pak for Data 5.0.x | Installing 5.0.1 |
| 5.0.0 | IBM Cloud Pak for Data 5.0.x | Installing 5.0.0 |
| 4.8.5 | IBM Cloud Pak for Data 4.8.x | Installing 4.8.5 |
| 4.8.4 | IBM Cloud Pak for Data 4.8.x | Installing 4.8.4 |
Support matrix for IBM Cloud Pak for Data
Check the compatibility of your IBM watsonx Orchestrate version with IBM Cloud Pak for Data and Red Hat OpenShift:
| watsonx Orchestrate version | IBM Cloud Pak for Data version | Red Hat OpenShift version |
|---|---|---|
| 5.0.3 | 5.0.x | 4.12, 4.14, 4.15, or 4.16 |
| 5.0.1 | 5.0.x | 4.12, 4.14, or 4.15 |
| 5.0.0 | 5.0.x | 4.12, 4.14, or 4.15 |
| 4.8.5 | 4.8.x | 4.12, 4.14, or 4.15 |
| 4.8.4 | 4.8.x | 4.12 or 4.14 |