> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IBM Software Hub compatibility

This page provides version compatibility information for the watsonx Orchestrate ADK when deployed on IBM Software Hub (on-premises).

## Overview

When deploying watsonx Orchestrate on IBM Software Hub, it's essential to use the correct ADK version that corresponds to your IBM Software Hub version. This ensures optimal performance and compatibility.

<Note>
  For air-gapped environment setup instructions, see [Operating in an air-gapped environment](air_gap_environment).
</Note>

## Compatibility matrix

The following table shows the supported ADK versions for each IBM Software Hub release:

| Release Date      | IBM Software Hub Version | ADK Version | Standard Environment | Air-Gapped Environment |
| :---------------- | :----------------------- | :---------- | :------------------- | :--------------------- |
| 30 June, 2025     | 5.2.0                    | 1.6.2       | Supported            | Not supported          |
| 30 July, 2025     | 5.2.0.1                  | 1.6.x       | Supported            | Not supported          |
| 27 August, 2025   | 5.2.1                    | 1.8.x       | Supported            | Contact IBM support    |
| 30 October, 2025  | 5.2.2                    | 1.12.x      | Supported            | Supported              |
| 15 December, 2025 | 5.3.0                    | 1.14.x      | Supported            | Supported              |
| 26 February, 2026 | 5.3.1                    | 2.3.x       | Supported            | Supported              |
| 13 April, 2026    | 5.3.1 Patch 2            | 2.7.x       | Supported            | Supported              |
| 21 May, 2026      | 5.3.1 Patch 5            | 2.10.x      | Supported            | Supported              |
| 17 June, 2026     | 5.4.0                    | 2.11.x      | Supported            | Supported              |

## Version selection guidelines

When selecting an ADK version:

1. **Match your IBM Software Hub version**: Always use the ADK version that corresponds to your IBM Software Hub deployment
2. **Check air-gapped support**: If operating in an air-gapped environment, verify that your IBM Software Hub version supports it
3. **Apply patches**: For patch releases, use the specified ADK version to ensure compatibility with bug fixes and improvements

<Warning>
  Using an incompatible ADK version may result in unexpected behavior or functionality issues. Always verify version compatibility before deployment.
</Warning>

## Installing the ADK

To install a specific ADK version:

```bash theme={null}
pip install ibm-watsonx-orchestrate==<version>
```

Replace `<version>` with the appropriate version from the compatibility matrix (e.g., `2.13.0`).

## Related resources

* [Operating in an air-gapped environment](environment/air_gap_environment)
* [Initiate environment](environment/initiate_environment)
* [Installing the ADK](getting_started/installing)