Is this page helpful?

Prerequisites#

This section describes the hardware and software requirements for running Halos SIL.

Minimum System Requirements#

  • x86-64 architecture

  • 16+ core CPU

  • 32 GB RAM

  • 200 GB SSD

  • NVIDIA GPU with 24 GB+ VRAM (RTX 5090 x1, Pro 6000 Workstation x1 or L40S x2)

Software Requirements#

  • Ubuntu 22.04 LTS / 24.04 LTS

  • NVIDIA Driver 580.95.05+

  • Docker 28.4+

  • Docker Compose Plugin v2.39.x+

  • NVIDIA Container Toolkit 1.17.4+

Authentication Requirements#

Important

The Safety Core container image is hosted on NGC under gated access. Before pulling the image, complete the following one-time setup:

  1. Accept the NGC invitation — An enrollment email is sent when your access is approved. Click the link in the email to join the NGC organization. If you did not receive the email or it has expired, contact your NVIDIA representative to have it resent.

  2. Sign in to NGC — Log in at https://ngc.nvidia.com with your NVIDIA account.

  3. Accept the license agreement — Navigate to the Halos Outside-In Safety resource page and accept the governing terms and user agreements when prompted.

NGC docker Authentication#

  • Create NGC API key: https://ngc.nvidia.com → Account → Setup → Generate API Key

  • Required for downloading Docker images.

  • NGC CLI authentication is not enough for Docker image pulls. Docker must be authenticated to nvcr.io or protected image pulls fail with 401 Unauthorized.

export PSF_IMAGE=nvcr.io/nvidia/halos-outside-in/outside-in-safety:nv-psf-halos-1.2.1-3041f93

docker login nvcr.io
# Username: $oauthtoken
# Password: <NGC API key>

# Validate Docker registry access before deployment.
docker pull "${PSF_IMAGE}"

NGC CLI Authentication#

Required for downloading data, docker compose.

ngc config set
# API Key: <NGC API key>

Next Steps#