Skip to main content

​
Installation

Use this page when the Quick Start prerequisite check fails or when you need more control over installation and launch behavior.

​
Requirements

The current package requires Python 3.11+. The bootstrap path also requires git, curl, and Python venv support. whiptail is optional but recommended for the menu UI. Check the environment:
If the available Python runtime is older than 3.11, install a supported Python 3.11+ runtime for your Linux distribution before running DSP. The bootstrap installer intentionally stops instead of creating a virtual environment with an older Python version.
On Debian/Ubuntu systems where the default python3 is already 3.11 or newer, the usual packages are:
The installer uses $HOME/xdr-poc-script by default and:
  1. verifies git and a Python 3.11+ runtime with venv
  2. preserves ~/.dsp/config.env and existing runs
  3. clones or updates the current operator branch
  4. creates or reuses .venv
  5. installs DSP with pip install -e .
  6. launches dsp-menu.sh
The online bootstrap normally needs access to GitHub and to the Python package source used by pip. The current bootstrap is not an offline installer. In restricted environments, pre-stage the repository and required Python dependencies using the customer’s approved software-transfer process.

​
Custom install directory

​
Install without opening the menu

Launch the default-path installation later with:

​
Manual install

If you prefer not to pipe a script into bash:

​
Update an existing installation

The simplest update method is 1 — Update latest patch in the operator menu. You can also rerun the bootstrap installer; it updates the existing repository and preserves ~/.dsp/ state.
The current product scripts use release/v1.4.0-rc. The older release/v1.4.0 branch is explicitly rejected by the installer/menu because it contains retired traffic-volume behavior.

​
Verify the installation

Expected product version is dsp 1.4.0 on the current operator branch.

Run the first test

Continue with local mode and the normal profile before configuring webshell execution.