> 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/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/single-server-deployment/install-the-server-offline.md).

# Install the Server Offline

Use these instructions when using the Cortex XSOAR installer script for installation with no internet connectivity.

You need to download Cortex XSOAR [dependencies](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/single-server-deployment/install-the-server-offline/dependencies-for-offline-installation.md) and [Docker images](#UUID-865cb828-8fa3-c75a-0667-02521e89023f_id04db3c5b-ecc8-4ce7-aee1-008f5782bfe6) on a machine that has internet access, and then transfer them to a machine where you want to install Cortex XSOAR. After installing the Cortex XSOAR server from Cortex Gateway, install the dependencies and images.

Always verify that your Cortex XSOAR dependencies are updated and take into account that they might change across releases.

{% hint style="info" %}

### Note

* There are different steps for different operating systems.
* Docker/Podman is used to run Python scripts in an isolated container.
* After installation, you need to [Add a License](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/single-server-deployment/add-a-license.md).
  {% endhint %}

#### How to install Cortex XSOAR offline

1. On a machine with internet access, do the following:
   1. Download and install offline the [required dependencies](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/single-server-deployment/install-the-server-offline/dependencies-for-offline-installation.md) for your deployment type.

      1. Run the command **`#sudo apt-get install --download-only <package name>`**

         This will download the package and any dependencies it may have to the folder `/var/cache/apt/archives`.

         If the newest version is already installed, you can download the package by running the command **`#sudo apt-get download <package name>`**

         This will download the package to the folder the command is run from.
      2. Copy all .deb files over to the offline machine into a folder.
      3. Install all dependencies offline by running the command **`#sudo dpkg -i *`**

      <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><h3>Note</h3><p>If you need to download dependencies on Ubuntu, you can also use the command <strong><code>sudo apt-get download</code></strong>.</p></div>
   2. Ensure the Cortex XSOAR installer and license files are downloaded from Cortex Gateway.
   3. Download the Docker images by appending **`downloadName=dockerimages`** to the download URL you copied from the installer download.

      For example:

      **`https://download.demisto.com/download-params?token=xxxxxxx email=user@paloaltonetworks.com downloadName=dockerimages eula=accept`**

      The Docker images file is approximately 75 GB.
   4. Verify Docker is installed (it is typically installed with Cortex XSOAR). If it is not, install it. For example, for Ubuntu see [Install Docker on Ubuntu without direct internet connection](https://itadminguide.com/install-docker-on-ubuntu-without-direct-internet-connection/).
2. On the machine where you want to install Cortex XSOAR offline, do the following:
   1. Transfer the dependency files downloaded in step 1.
   2. Verify that the required dependencies in step 1 are installed successfully by running one of the following commands.
      * (Red Hat) **`repoquery -a --installed`**
      * (Ubuntu) **`apt list --installed`**
3. Install Cortex XSOAR offline by running the following command:

   (Red Hat or Ubuntu) **`sudo ./demisto.sh -- -tools=false -do-not-start-server=true`**
4. (Red Hat v8 & above) Install and configure Podman, by following the steps in [Migrate From Docker to Podman](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/podman/migrate-from-docker-to-podman.md) (from step 2 onwards).

   For other OS versions, you need to install Docker.
5. Upload the Docker images that you downloaded in step 1 by doing one of the following:
   * (Ubuntu, Red Hat v7 & below) Run the following command:

     **`sudo docker load -i <YOUR_DOCKER_FILE>.tar`**
   * (Red Hat v8 & above) Do the following:
     1. Ensure that the docker file has **`demisto:demisto`** ownership.
     2. Ensure that you are in the root directory (**`cd /`**).
     3. Run the following commands:

        **`sudo -su demisto`**

        **`podman load -i <YOUR_DOCKER_FILE>.tar`**
     4. (Optional) To verify that images are able to run, use the **`podman images`** command. You can also run the **`podman images -q "demisto/python:1.3-alpine"`** command to validate specific images and identify any issues.
6. Start the server by running the following command:

   **`sudo systemctl start demisto`**
7. (Optional) After installation has completed, do the following:
   1. Confirm that the Cortex XSOAR server status is active, by running the **`systemctl status demisto`** command.
   2. (Ubuntu, Red Hat v7 & below) Confirm that the Docker service status is active, by running the **`systemctl status docker`** command.
   3. In a web browser, go to the **`https://serverURL:port`** to verify that Cortex XSOAR was successfully installed.

      When you open Cortex XSOAR for the first time you need to add the license.

### **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/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/marketplace/install-a-content-pack-offline.md#UUID-680afcb3-2715-a6be-aef0-adbd63ed5651).
* 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/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/marketplace/install-a-content-pack-offline.md).
* Do custom configuration for your use case.

  For example, customize playbooks, sub-playbooks, or create custom indicators. For more information, see
* (Optional) Install an engine offline.

  For more information, see [Install a Cortex XSOAR Engine Offline](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/engines/engine-installation.md#UUID-cc730522-e8b2-4a0e-96a5-daed5440104b).
* (Informational) Set relevant server configurations.

  For more information, see [Reference](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/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/learn-about-cortex-xsoar/onboarding-in-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.