Pre-requisite Installation
Prerequisites
System requirements for running Visionaire4 — OS, Docker, GPU, and optional dependencies.
Before starting, make sure your machine meets these requirements.
Required
| Requirement | Details |
|---|---|
| Operating System | Linux (Ubuntu 22.04 or later) |
| Docker Engine | 20.10 or later |
| PostgreSQL 12 | Can run as a Docker container (covered in step 1) |
| License Credentials | Access key, secret key, and deployment key from NodeFlux |
| Network Access | Machine must reach your IP cameras / RTSP streams |
| RAM | 8 GB minimum, 16 GB recommended |
| Disk Space | 20 GB free for Docker image and data |
For GPU mode
Skip this section if you plan to run on CPU only.
| Requirement | Details |
|---|---|
| NVIDIA GPU | CUDA-capable (T4, RTX 2080, RTX 3090, A100, etc.) |
| NVIDIA Driver | Version 525 or later |
| NVIDIA Container Toolkit | Required for the --gpus flag |
Don't have a GPU? You can still run Visionaire4 in CPU mode by setting VISIONAIRE4_RUN_MODE=CPU. CPU mode supports a smaller set of analytics with reduced throughput — see CPU-Only Deployment.
Optional
| Requirement | When you need it |
|---|---|
| FremisN | Only for Face Recognition (provides 1:N face search) |
| External AI Service | Only for NFV4D-* analytics (e.g., fire detection, riot detection) — runs on port 4008 |