InstallationAir Gapped

Air Gapped Deployment

Deploy Prediction Guard in completely isolated environments with no external internet access

Prerequisites

  • Linux server (Ubuntu 20.04+ or RHEL 8+)
  • Minimum 32GB RAM (64GB recommended for large models)
  • 500GB+ storage (1TB+ recommended)
  • Docker pre-installed or installation package
  • No internet access required after initial setup

Create Your System in the Admin Console

  1. Navigate and login to admin.predictionguard.com
  2. View the Systems page and click on + Create System in the top-right.
  3. Provide a System Name
  4. Enable Air-Gapped System option
  5. Click Create System.

Installation Instructions

  1. Download the air-gapped installation package from the link provided by your Prediction Guard account representative.

  2. Untar the installation file:

$tar xvzf prediction-guard-air-gapped.tgz
  1. Run the installer, which will run pre-flight checks to ensure compatible environment:
$sudo ./prediction-guard-air-gapped install --license license.yaml

Provide a password for the local admin console. This is rarely used, but can be helpful for updating certain fields for offline systems. The installer will run through a series of pre-flight checks to ensure compatibility. If any of the pre-flight checks fail, a message will be displayed regarding which checks are failing. Either attempt to address and resolve the issue (some are related to available disk space, performance, etc.) or reach out to your Prediction Guard account representative for assistance. Once the installer has completed, proceed to step 4.

  1. Shell into the system to run the bootstrap command:
$sudo ./prediction-guard-air-gapped shell

  1. Retrieve the bootstrap command from admin.predictionguard.com by navigating to Systems, then clicking the Deploy button in the row of the system you wish to deploy. Click the Copy button above the deploy command and proceed to step 6.

  2. Paste the bootstrap command into the terminal where you are shelled into the system. This will install your authentication token and begin the initial bootstrapping of Prediction Guard services. After a few minutes, feel free to check the installation by checking the running services:

$docker ps | grep predictionguard

You should see running services, including pg-inside indicating that the system has been successfully installed. The system should also show as Healthy in the Admin Console.

  1. Deploy any desired AI models from the Models page in the Admin Console. Only Private Models can be deployed in air-gapped environments — Managed Models and External Models require internet access and are not available.