v4 Air-Gapped Quickstart

This guide covers installing Senzing v4 on systems without internet access. On a connected machine, download the required packages or Docker images, transfer them to the air-gapped system, and install. After installation, continue with the Linux quickstart or Docker quickstart to configure, initialize, and load data.

The only network requirement is access to your database. Senzing does not require internet connectivity after installation.

Linux

The Senzing v4 SDK is distributed as Linux packages. Choose the package that fits your use case:

Package	Contents
`senzingsdk-runtime`	The main Senzing SDK package.
`senzingsdk-tools`	Contains `er/bin` utilities such as `sz_command`, `sz_configtool`, and the EDA tools (`sz_explorer`, `sz_audit`, `sz_snapshot`).
`senzingsdk-setup`	Contains `er/bin` upgrade utilities `sz_dbupgrades`, `sz_configupgrade`, and `er/resources` files and templates.
`senzingsdk-poc`	Installs `senzingsdk-runtime`, `senzingsdk-setup`, and `senzingsdk-tools`. Contains utilities for the Linux Quickstart including `sz_create_project`, `sz_setup_config`, `sz_update_project`, `sz_fileloader`, and a SQLite database. Recommended for evaluation.

All senzingsdk-* packages require exact version matching. Download the same version of each package.

Download with package manager

Add the Senzing repository on a connected machine, then use the package manager to download the packages and all their dependencies.

Debian / Ubuntu:

# Add Senzing repository
wget https://senzing-production-apt.s3.amazonaws.com/senzingrepo_2.0.1-1_all.deb
sudo apt install ./senzingrepo_2.0.1-1_all.deb
sudo apt update

# Download senzingsdk-poc and all dependencies
apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests \
  --no-conflicts --no-breaks --no-replaces --no-enhances \
  senzingsdk-poc | grep "^\w" | sort -u)

Red Hat / Amazon Linux:

# Add Senzing repository
sudo yum install https://senzing-production-yum.s3.amazonaws.com/senzingrepo-2.0.1-1.noarch.rpm

# Download senzingsdk-poc and all dependencies
yumdownloader --resolve senzingsdk-poc

Download packages manually

Alternatively, browse the S3 index pages and download the .deb or .rpm files for your platform:

Platform	Download URL
Debian 12, Ubuntu LTS >= 22.04	senzing-production-apt (bookworm)
Debian 11	senzing-production-apt (stable)
RHEL 9, Amazon Linux 2023	senzing-production-yum (rhel/9)
RHEL 8	senzing-production-yum (rhel/8)

When downloading manually, also download any missing system dependencies. The senzingsdk-runtime package requires zlib1g, libc6, libstdc++6, libgcc1, and libssl3 (Debian names). The senzingsdk-tools package additionally requires python3, less, python3-prettytable, python3-psutil, and python3-typing-extensions. Use the Install packages verification step to check for missing dependencies before installing.

Transfer files

Copy all downloaded .deb or .rpm files to the air-gapped system using your organization’s approved transfer method (USB drive, secure file transfer, etc.).

Install packages

Debian / Ubuntu:

# Verify no missing dependencies
dpkg --dry-run -i senzingsdk-*.deb

# Install
sudo dpkg -i senzingsdk-*.deb

Red Hat / Amazon Linux:

# Verify no missing dependencies
rpm --test -i senzingsdk-*.rpm

# Install
sudo rpm -i senzingsdk-*.rpm

Continue setup

After installation, continue with the Linux quickstart to create a project, configure the environment, set up the database, and load the truth-set demo data:

Linux Quickstart → Create a Senzing project

Docker

Senzing v4 provides Docker images for containerized deployments. Save the required images on a connected machine and load them on the air-gapped system.

Image	Purpose
`senzing/senzingsdk-runtime`	Base image for building custom applications (loaders, REST APIs, etc.).
`senzing/senzingsdk-tools`	Interactive CLI tools for EDA and administration.
`senzing/sz-file-loader`	Runs `sz_file_loader` to load records from JSONL files and perform entity resolution.
`senzing/init-database`	One-time database initialization: applies schema DDL and registers the default configuration.

Pull and save images

On a connected machine, pull the required images and save them to an archive:

docker pull senzing/senzingsdk-runtime:latest
docker pull senzing/senzingsdk-tools:latest
docker pull senzing/sz-file-loader:latest
docker pull senzing/init-database:latest

# Save all images to a single archive
docker save senzing/senzingsdk-runtime:latest \
            senzing/senzingsdk-tools:latest \
            senzing/sz-file-loader:latest \
            senzing/init-database:latest \
  -o senzing-images.tar

If you have custom application images built on senzing/senzingsdk-runtime, include those in the docker save command as well.

Transfer the archive

Copy senzing-images.tar to the air-gapped system.

Load images

docker load -i senzing-images.tar

Continue setup

After loading the images, continue with the Docker quickstart to configure the engine, initialize the database, and load the truth-set demo data:

Docker Quickstart → Setting up SENZING_ENGINE_CONFIGURATION_JSON

If you have any questions, contact Senzing Support. Support is 100% FREE!