Installation
Overview
This installation and configuration guide provides a step-by-step process for deploying Scylla's video analytics on Nvidia Jetson devices. Scylla’s advanced video analytics solutions leverage AI and deep learning models to enhance surveillance systems by providing real-time, automated detection of various objects and behavior anomalies.
The installation script is encrypted; you will be prompted to enter a decryption key. You can obtain a key by contacting support@scylla.ai please provide your license key ID so support can identify you as a customer.
Prerequisites
Before proceeding with the installation, ensure the following prerequisites are met, Once done, you can proceed with the installation steps below.
SSH Access
SSH (Secure Shell) is a cryptographic network protocol used for secure data communication, remote command-line login, and other secure network services between two networked computers. It provides strong authentication and encrypted data communications.
There are several common ways to SSH into the AI box:
- Local Network Access
The client PC (laptop or desktop) is on the same local network as the AI box.
- Access via Jump Server
The client PC connects to an intermediate computer (jump server) that resides on the same network as the AI box.
- Direct Access via Public IP
The AI box is assigned a public IP address, allowing the user to connect over the internet using either password or SSH key authentication.
Internet Connectivity
Ensure the AI box has an active internet connection to allow for software installation, updates, and remote support if needed.
Compatibility Check
The following table lists the supported software features and their abbreviations used throughout this documentation.
| AI module name | Description | Short Name |
|---|---|---|
| Intruder Detection | Detects person or vehicle intrusions | ids |
| Gun Detection | Identifies presence of firearms such as guns rifles shotguns | ptd |
The table below outlines the compatibility of supported features with various NVIDIA Jetson hardware platforms and Jetpack OS versions.
| OS Version | Orin Nano 8GB | Orin NX 8GB | Orin NX 16GB | Xavier NX |
|---|---|---|---|---|
| Jetpack 6.0 GA (R36.3.0) | PTD, IDS | PTD | PTD, IDS | |
| Jetpack 6.0 DP (R36.2.0) | PTD, IDS | PTD | PTD, IDS | |
| Jetpack 5.1.1 (R35.3.1) | IDS | PTD, IDS | IDS | |
| Jetpack 4.6 (R32.6.1) | PTD, IDS |
Dependency Check
These dependencies are critical for the proper functioning of the system and must be matched to your device's OS and Jetpack version.
The installation script will assume that the exact version of the following dependencies is installed and configured properly based on the device type and OS prior running the installation. This is applicable to all types of devices except Hanwha Jetson Camera or AI Box
| OS Version | Jetpack Version | Cuda | cuDNN | TensorRT | Nvidia Container Toolkit | Docker |
|---|---|---|---|---|---|---|
| Ubuntu 22.04 | Jetpack 6.0 GA (R36.3.0) | 12.2.140 | 8.9.4.25 | 8.6.2.3 | 1.14.2-1 | 27.1.1 |
| Ubuntu 22.04 | Jetpack 6.0 DP (R36.2.0) | 12.2.140 | 8.9.4.25 | 8.6.2.3 | 1.14.2-1 | 27.1.1 |
| Ubuntu 20.04 | Jetpack 5.1.1 (R35.3.1) | 11.4.315 | 8.6.0.166 | 8.5.2.2 | 1.11.0~rc.1-1 | 26.1.3 |
| Ubuntu 18.04 | Jetpack 4.6 (R32.6.1) | 10.2.300 | 8.2.1.32 | 8.0.1.6 | 1.0.1-1 | 20.10.21 |
Installation
If you are installing on Hanwha Jetson Camera or AI Box You must specify the following environment variable
export SCYLLA_HANWHA_WISENET_ENABLED=1
Environment Variables
Below is a table describing the environment variables that can be used to configure Scylla Asteria. These variables control installation options, debugging, integrations, and other behaviors. Adjust them as needed for your deployment.
| Variable | Description | Required | Default | Example Value |
|---|---|---|---|---|
SCYLLA_MODULE_NAME | Module to install (PTD = Weapons Detection, IDS = Intrusion Detection System) | Yes | N/A | PTD |
SCYLLA_DEBUG_ENABLED | Enable debug mode (1 = enabled, default is 0 if not set) | No | 0 | 1 |
SCYLLA_SHOW_PROGRESS | Show installation progress (1 = enabled) | No | 0 | 1 |
SCYLLA_TELE_LABEL_OWNER | Customer/owner label for telemetry | No | N/A | "CustomerX" |
SCYLLA_NETRINOS_ENABLED | Enable Netrinos integration (1 = enabled) | No | 0 | 1 |
SCYLLA_ROOT_PASS | Change root password of the server | No | N/A | "securePass123" |
SCYLLA_AI_COMPONENT_VERSION | Specify custom AI component version for updates | No | Latest | "v1.2.3" |
SCYLLA_DECRYPT_PASSPHRASE | Specify decryption key | No | None | "mySecretKey" |
SCYLLA_FRONTEND | Set to "noninteractive" to run the installation in unattended mode | No | N/A | "noninteractive" |
SCYLLA_HANWHA_WISENET_ENABLED | Set to 1 to install components on wisenet AI box and camera | No | NA | 1 |
SCYLLA_LEGACY_XAVIER_SUPPORT=0 | Set to 1 to install to use legacy component of IDS (dashboard v5.3.0) | No | NA | 1 |
PTD (Weapons Detection)
export SCYLLA_MODULE_NAME=PTD
export SCYLLA_SHOW_PROGRESS=1
export SCYLLA_TELE_LABEL_OWNER=GoodCustomer
sudo -E bash -c "$(curl -fsSL https://edge.install.scylla.site/scripts/install.sh)"
This script will configure the device and download the latest version of PTD (Gun Detection) software.
IDS (Intrustion Detection)
export SCYLLA_MODULE_NAME=IDS
export SCYLLA_SHOW_PROGRESS=1
export SCYLLA_TELE_LABEL_OWNER=GoodCustomer
sudo -E bash -c "$(curl -fsSL https://edge.install.scylla.site/scripts/install.sh)"
This script will configure the device and download the latest version of IDS (Intrustion Detection System) software.
Example installing on Hanwha Jetson Camera or AI Box
export SCYLLA_HANWHA_WISENET_ENABLED=1
export SCYLLA_MODULE_NAME=PTD
export SCYLLA_SHOW_PROGRESS=1
export SCYLLA_TELE_LABEL_OWNER=GoodCustomer
sudo -E bash -c "$(curl -fsSL https://edge.install.scylla.site/scripts/install.sh)"
Please note that depending on the internet connection, downloading may take some time, so once the script is finished, give it enough time to download the software, you can always check the status by typing docker ps.
Access web UI
Once the download is complete, use the device IPv4 to access the web UI default credentials are admin/admin. For the dashboard user manual or installation support contact support@scylla.ai
For Hanwha Jetson Camera or AI Box:
Use the camera's IPv4 to access the web UI and follow the steps below to configure the dashboard ports:
- Login to the camera UI on the left side and select Basic / IP and PORT.
- Scroll down to Jetson port:
- For “to camera”, type
8080. - For “to jetson”, type
8080.
- For “to camera”, type
- Click Apply to save the configuration.
- Login to the dashboard by typing the camera IP followed by port
8080.
Remove and Reinstall
This section describes a command that can remove software configuration and data. Double-check your input!
There are cases where you might want to remove or clean up the device and reinstall the software. For example, if a device has IDS installed but you want to switch to PTD, run the delete script first.
Specify this environment variable to avoid deleting software images. This is useful if you need to reinstall the software, as it will take less time to download the image by pulling only updates from the remote repository instead of the entire image.
export SCYLLA_DELETE_DOCKER_IMAGES=0
Open terminal window and type the following command
sudo -E bash -c "$(curl -fsSL https://edge.install.dev.scylla.site/scripts/delete.sh)"
Once cleanup is finished you can install the software again if you want to.