> 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/single-server-deployment/install-the-server-offline.md).

# Install the Server Offline

Install Cortex XSOAR 6.13 when you do not have internet access. Instructions for offline installation.

Download the required dependencies, installer, license files, and Docker images from an internet-connected machine. Transfer them to the offline server. Then install the dependencies, Cortex XSOAR, and Docker images.

If you are deploying a signed installer:

* Import the public key into the operating system. Open a [support ticket](https://support.paloaltonetworks.com/Support/Index) to obtain the key. It is valid for six months.
* Install `makeself` when you use engines or hosts in a multi-tenant environment.

{% hint style="info" %}

* Download the latest dependencies for your Cortex XSOAR release before installation. Dependencies can change between releases.
* Steps vary by operating system.
* Docker or Podman runs Python scripts in isolated containers.
* Add the license after installation. See [Add a License](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/single-server-deployment/add-a-license.md).
  {% endhint %}

### Prerequisites for installing Cortex XSOAR

Verify the following requirements before you install Cortex XSOAR:

* A Customer Support Portal account
* The Super User and Account Admin roles
* A license assigned to your Customer Support Portal account
* A deployment that meets the [System Requirements](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/single-server-deployment/system-requirements.md)
* Root access

Set up your Customer Support Portal account. For more information, see [How to Create Your CSP User Account](https://knowledgebase.paloaltonetworks.com/KCSArticleDetail?id=kA10g000000ClNVCA0).

### Install Cortex XSOAR offline

{% stepper %}
{% step %}

### Download the required dependencies

1. On an internet-connected machine, download the [required dependencies](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/single-server-deployment/install-the-server-offline/dependencies-for-offline-installation.md) for your deployment type.
2. For Ubuntu or Debian, run `sudo apt-get install --download-only <package>`.

   The command saves packages and dependencies in `/var/cache/apt/archives`.
3. For RHEL, Rocky Linux, Oracle Linux, or Amazon Linux, run `sudo yumdownloader --resolve <package>` or `sudo yum install --downloadonly <package>`.
4. Transfer the downloaded dependency files to a folder on the offline server.
   {% endstep %}

{% step %}

### Download the installation files

1. On an internet-connected machine, log in to [Cortex Gateway](https://cortex-gateway.paloaltonetworks.com/accounts).
2. Locate the activation card for your license.
3. Select **Download On Prem**.
4. Select **Next**.
5. Under **Choose Download Option**, select **Installer**.
6. Select the checkbox to agree to the license terms and conditions.
7. Select **Download**.

The installer file, `demistoserver-xxxxx.sh`, and a zipped JSON license file download.

{% hint style="info" %}
Copy the download link from your browser's **Downloads** section. The link contains the token needed to download Docker images.
{% endhint %}

8. Optional: Import the GPG public key when using a signed installer.
9. Optional: Install `makeself` when required. Run `yum install makeself`.
   {% endstep %}

{% step %}

### Download Docker images

On an internet-connected machine, download the Docker images:

* **Targeted download:** Use the `download_packs_and_docker_images.py` script. See [Download packs offline](https://xsoar.pan.dev/docs/reference/articles/download-packs-offline).
* **Full library download:** Append `downloadName=dockerimages` to the installer download URL. The Docker images file is approximately 75 GB.
  {% endstep %}

{% step %}

### Transfer and install dependencies

1. Transfer the files downloaded in the previous steps to the offline server.
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 Cortex XSOAR

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

1. Run `chmod +x demisto.sh`.
2. Run `sudo ./demisto.sh -- -tools=false -do-not-start-server=true`.

For multi-tenant deployments, also include the `-multi-tenant` flag.
{% endstep %}

{% step %}

### Load Docker images

* **Ubuntu, Oracle Linux, or Amazon Linux:** Run `sudo docker load -i <YOUR_DOCKER_FILE>.tar`.
* **RHEL 8 and later, or Rocky Linux 9 and later:**
  1. Set file ownership 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`.
     {% endstep %}

{% step %}

### Start Cortex XSOAR

Run `sudo systemctl start demisto`.
{% endstep %}

{% step %}

### Verify the installation

1. Confirm the Cortex XSOAR server is active with `systemctl status demisto`.
2. For Docker deployments, confirm the Docker service is active with `systemctl status docker`.
3. Open `https://serverURL:port` in a web browser.

The Cortex XSOAR server is installed and ready for license activation.
{% endstep %}
{% endstepper %}

### Troubleshoot offline installation

If you receive the following message, ensure you use a version of Podman that supports archives with multiple images.

`Error: error pulling "": unable to pull dir:./xsoar_docker_images.tar: error determining pull goal for image "dir:./xsoar_docker_images.tar": error parsing dest reference name "localhost/./xsoar_docker_images.tar": error parsing named reference "localhost/./xsoar_docker_images.tar": invalid reference format`

### Next steps

After you successfully complete your Cortex XSOAR offline installation, you will likely need to:

* Turn off Marketplace synchronization.

  For more information, see [Configure the Marketplace for Offline Installation](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/marketplace/install-a-content-pack-offline.md#configure-the-marketplace-for-offline-installation).
* Download content packs offline.

  For more information, see [Download Content Packs and Docker Images Offline](https://xsoar.pan.dev/docs/reference/articles/download-packs-offline) and [Install a Content Pack Offline](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/marketplace/install-a-content-pack-offline.md).
* (Optional) Install an engine offline.

  For more information, see [Install a Cortex XSOAR Engine Offline](/xsoar-6-administrator-guide/6.13/onboard-cortex-xsoar/engines/engine-installation.md).
* (Informational) Set relevant server configurations.

  For more information, see [Reference](/xsoar-6-administrator-guide/6.13/reference-docs/reference.md).


---

# 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/single-server-deployment/install-the-server-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.