> ## 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.

# Kubernetes on-premises compatibility

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

## Overview

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

## Compatibility matrix

The following table shows the supported ADK versions for each watsonx Orchestrate on Kubernetes release:

| Release Date | Kubernetes Release Version | ADK Version |
| :- | :- | :- |
| 9 September, 2026 | 1.0.0 | 2.12.2 |
| 15 October, 2026 | 1.1.0 | 2.16.0 |

## Version selection guidelines

When selecting an ADK version:

1. **Match your Kubernetes release version**: Always use the ADK version that corresponds to your watsonx Orchestrate on Kubernetes deployment
2. **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.16.0`).

## Related resources

* [IBM Software Hub compatibility](environment/onprem_compatibility)
* [Initiate environment](environment/initiate_environment)
* [Installing the ADK](getting_started/installing)
* [Configure the ADK for watsonx Orchestrate on Kubernetes](https://www.ibm.com/docs/en/watsonx/watson-orchestrate/base?topic=kubernetes-configure-agent-development-kit-watsonx-orchestrate) — platform-side Kubernetes configuration required before connecting the ADK to an on-premises deployment