> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/engines/engine-installation/install-a-cortex-xsoar-engine-offline.md).

# Install a Cortex XSOAR Engine Offline

Install an engine offline in Cortex XSOAR 6.13.

Use this procedure to install a Cortex XSOAR engine without internet connectivity.

Download the [Dependencies for Offline Installation](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/single-server-deployment/install-the-server-offline/dependencies-for-offline-installation.md) and [Docker Images in Cortex XSOAR](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/docker/docker-images-in-cortex-xsoar.md) on an internet-connected machine. Transfer the files to the engine machine. Install the dependencies and images after installing the engine.

Download the latest dependencies for your release. Dependencies can change between releases.

### Install an engine offline

{% stepper %}
{% step %}

### Download the required dependencies

1. Download the [Dependencies for Offline Installation](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/single-server-deployment/install-the-server-offline/dependencies-for-offline-installation.md) for your deployment.
2. Download packages for your operating system:
   * **Ubuntu or Debian:** Run `sudo apt-get install --download-only <package>`. The package and its dependencies are saved in `/var/cache/apt/archives`. If the newest version is already installed, run `sudo apt-get download <package>`.
   * **Red Hat Enterprise Linux (RHEL), Rocky Linux, Oracle Linux, or Amazon Linux:** Run `sudo yumdownloader --resolve <package>` or `sudo yum install --downloadonly <package>`.
3. Copy the `.deb` files to a folder on the offline machine.
   {% endstep %}

{% step %}

### Download Docker images

The installer sets up Docker but does not include integration images. Download the required images on an internet-connected machine:

* **Targeted download:** Use `download_packs_and_docker_images.py` to download images for required content packs. Download the script from the Git content repository or [GitHub](https://raw.githubusercontent.com/demisto/content/master/Utils/download_packs_and_docker_images.py). For details, see [Download packs offline](https://xsoar.pan.dev/docs/reference/articles/download-packs-offline).
* **Full library download:** Add `downloadName=dockerimages` to the installer download URL. The Docker image archive is approximately 75 GB.
  {% endstep %}

{% step %}

### Create an engine

1. Select **Settings** → **Integrations** → **Engines** → **Create New Engine**.
2. Enter a name in **Engine Name**.
3. Select an installer type.

   Use the Shell installer for Linux systems.
4. Optional: Select a load-balancing group.

   This list appears after you create and connect an engine and group.
5. Optional: Select the checkbox to run multiple Shell engines on one machine.
6. Optional: Add required configuration in JSON format.
7. Select **Create New Engine**.
   {% endstep %}

{% step %}

### Transfer and install dependencies

1. Transfer the downloaded files to the engine machine.
2. Install the dependencies:
   * **Ubuntu or Debian:** Run `sudo dpkg -i *`.
   * **RHEL, Rocky Linux, Oracle Linux, or Amazon Linux:** Run `sudo yum localinstall *`.
     {% endstep %}

{% step %}

### Install the engine

The installer configures Docker or Podman for Ubuntu, RHEL 8 or later, Rocky Linux 9 or later, and Amazon Linux 2023.

{% hint style="warning" %}
For Oracle Linux and Amazon Linux 2, install Docker before running the installer.
{% endhint %}

1. Run `chmod +x /<engine-file-path>`.
2. Run `sudo ./d1-<engine-name>-<XSOAR-version>-xxxxxxx.sh -- -tools=false -do-not-start-engine=true`.

For example, run `sudo ./d1-engine1-6.6-2458567.sh -- -tools=false -do-not-start-engine=true`.

If you receive a `permissions denied` error, verify access to `/tmp`.
{% endstep %}

{% step %}

### Load Docker images

* **Ubuntu, Oracle Linux, or Amazon Linux:** Run `sudo docker load -i <YOUR_DOCKER_FILE>.tar`.
* **RHEL 8 or later, or Rocky Linux 9 or later:**
  1. Set the archive owner with `sudo chown demisto:demisto <FILENAME>.tar`.
  2. Change to the root directory with `cd /`.
  3. Run `sudo -su demisto podman load -i <PATH_TO_FILE>/<FILENAME>.tar`.
  4. Optional: Validate the images with `podman images` or `podman images -q "demisto/python:1.3-alpine"`.
     {% endstep %}

{% step %}

### Start the engine

Run `sudo systemctl start d1`.

{% hint style="info" %}
For multiple engines, the D1 service name might differ.
{% endhint %}
{% endstep %}

{% step %}

### Verify the engine is active

1. Confirm that the engine is active with `systemctl status d1`.

   ![Engine service status](https://1226493512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BTuP6WlLsNzo2wlKa5w%2Fuploads%2F6EWBkOKJ3pamDcvHEH39%2F22f526cfdbd8650337df0ba7026ab8a35355069e6d869c852d12683693c449f0.png?alt=media\&token=c82ae95b-e353-4d85-bf1e-ef3f90194c57)
2. Verify that the engine is connected in **Settings** → **Integrations** → **Engines**.

   ![Engine connection status](https://1226493512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BTuP6WlLsNzo2wlKa5w%2Fuploads%2FWu1b3Z6V54GdsIsqAa6E%2F3fa06c43130db982261dc2c211477a03811dbfe8c13f5b2f1e295787955943ac.png?alt=media\&token=c95709b5-8cee-42d5-874c-32ccd2f2b3bb)
3. Run a sample integration on the engine.

   ![Integration configured to use the engine](https://1226493512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BTuP6WlLsNzo2wlKa5w%2Fuploads%2FYd8Q12vKHZPyZbkD5muu%2F0e7989528aed01b5539ef7f5fd95e12ad3ef31ec5ac29412cfe206c3ff0535da.png?alt=media\&token=9f56ae5b-c2da-41f0-a186-3e0ecdc84ca4)
4. Run a simple integration command.

   ![Integration command result](https://1226493512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BTuP6WlLsNzo2wlKa5w%2Fuploads%2FjcKtmy46bg4Coy5UQbig%2Fff19ba1b5e1e82ad8dc724de591095abcb1e36767d4f4d72b1a71f60751ac1a0.png?alt=media\&token=b87afca7-f37d-49b3-a3be-a31755754d9a)

The Cortex XSOAR engine is installed and ready to use.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/engines/engine-installation/install-a-cortex-xsoar-engine-offline.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.