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

# Tutorial: Operating in an air gapped environment

Using the ADK in an air gapped environment introduces additional challenges you need to address:

* The ADK Python package is hosted on PyPI. In an air gapped environment, it is inaccessible.
* By default, watsonx Orchestrate pulls packages from PyPI when installing Python tools.
* The watsonx Orchestrate Developer Edition is not available.

## Getting started

As a site administrator, you need to acquire:

* Access to a jumpbox which connects to both the internet and your Cloud Pak for Data Cluster.
* A locally hosted Python package registry accessible from your internal network. Examples of common PyPi registry providers include **Artifactory** and **Sonatype Nexus**, but other options are available.

### Uploading the ADK to your local pypi registry

<Steps>
  <Step title="Get dependencies list">
    On your jumpbox, run the following to get the full list of dependencies necessary to generate wheel files for each dependency of the ADK.

    ```bash BASH theme={null}
    # Install UV
    curl -LsSf https://astral.sh/uv/install.sh | sh

    # Create a UV Virtual environment
    uv venv adk --seed --python=3.12
    source adk/bin/activate

    pip install ibm-watsonx-orchestrate==<supported version>
    pip freeze > requirements.txt
    mkdir dependencies
    cd dependencies
    pip wheel -r requirements.txt
    ```
  </Step>

  <Step title="Copy wheel files">
    Copy all wheel files to your local PyPI registry provider.
  </Step>
</Steps>

### Fixing Python tool import

To import Python tools successfully, configure watsonx Orchestrate to pull the ADK from your local registry.
All python tools must be imported with a `requirements.txt` file. This file must contain at least the following:

```
--index-url https://my-pypi-registry
# optionally
my-dependency==dependency-version
```

<Note>
  **Note:**
  Any dependencies other than the ADK you want to utilize in your tools must also be uploaded by site administrator to your PyPI registry as well.
</Note>

## CPD - watsonx Orchestrate ADK compatibility chart

Below are the supported versions of the ADK
that should be used with each version of CPD.

| CPD Expected Release Date | CPD Version | ADK Version | CPD Support Of Non-air gapped ADK | CPD Support of air gaped ADK            |
| :------------------------ | ----------- | ----------- | :-------------------------------- | --------------------------------------- |
| 30 June, 2025             | 5.2.0       | 1.6.2       | Supported                         | No support                              |
| 30 July, 2025             | 5.2.0.1     | 1.6.x       | Supported                         | No support                              |
| 27 August, 2025           | 5.2.1       | 1.8.x       | Supported                         | Requires custom patch from support team |
| 29 October, 2025          | 5.2.2       | 1.12.x      | Supported                         | Supported                               |