Install Cortex XSOAR when you do not have internet access. Instructions for offline installation.
Use these instructions when using the Cortex XSOAR installer script for installation with no internet connectivity.
You need to download Cortex XSOAR dependencies and Docker images on a machine that has internet access, and then transfer them to a machine where you want to install Cortex XSOAR. After installing Cortex XSOAR server, install the dependencies and images.
Always verify that your Cortex XSOAR dependencies are updated and take into account that they might change across releases.
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.
On a machine with internet access, do the following:
Download the required dependencies for your deployment type.
(Red Hat) Run the following commands:
sudo yum check update
sudo yum install
<name of the dependency>
For example,
sudo yum install
systemd
(Ubuntu) Run the following commands:
sudo apt-get update
sudo apt-get install
<name of the dependency>
For example,
sudo apt-get install systemd
Note
If you need to download dependencies on Ubuntu, you can also use the command
apt-get download
.Download the Docker images by appending
downloadName=dockerimages
to the download link you received from Cortex XSOAR.For example:
wget -O dockerimages.tar "https://download.demisto.com/download-params?token=xxxxxxx&email=user@paloaltonetworks.com&downloadName=dockerimages&eula=accept"
Note
The Docker images file is approximately 75 GB.
If using Podman:
To archive a single Docker image, run:
podman save -o docker_images.tar <docker-image-1> <docker-image-2>
To archive multiple Docker images, run:
podman save --multi-image-archive -o docker_images.tar <docker-image-1> <docker-image-2>
Download Cortex XSOAR (if not already installed).
Note
When you receive a link to download, ensure that the
downloadLink
link refers tohttps://download.demisto.com
and nothttps://download.demisto.works
.For example,
wget -O demisto.sh “https://download.demisto.com/download-params?token=xabcedef&email=user@paloaltonetworks.com&eula=accept”
To download the latest vendor affirmed FIPS version, append
&downloadName=fips
. For example,wget -O demisto.sh “https://download.demisto.com/download-params?token=xabcedef&email=user@paloaltonetworks.com&eula=accept&downloadName=fips”
On the machine where you want to install Cortex XSOAR, do the following:
Transfer the files downloaded in step 1.
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
Install Cortex XSOAR, by running the following command:
(Red Hat or Ubuntu)
sudo ./demisto.sh -- -tools=false -do-not-start-server=true
(Red Hat v8 & above) Install and configure Podman, by following the steps in Migrate From Docker to Podman (from step 2 onwards).
For other OS versions, you need to install Docker.
Load 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:
Ensure that the docker file has
demisto:demisto
ownership.Ensure that you are in the root directory (
cd /
).Run the following commands:
sudo -su demisto
podman load -i <YOUR_DOCKER_FILE>.tar
(Optional) To verify that images are able to run, use the
podman images
command. You can also run thepodman images -q "demisto/python:1.3-alpine"
command to validate specific images and identify any issues.
Start the server, by running the following command:
sudo systemctl start demisto
(Optional) After installation has completed, do the following:
Confirm that the Cortex XSOAR server status is active, by running the
systemctl status demisto
command.(Ubuntu, Red Hat v7 & below) Confirm that the Docker service status is active, by running the
systemctl status docker
command.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