Pre-requisite Installation
A step-by-step guide to install, run, and configure Visionaire4 on Docker — from system requirements and quick start to the full configuration reference.
Pre-requisite Installation
This guide walks you through installing Visionaire4 with Docker — from preparing your machine to a working node you can hit with curl. Follow it top to bottom and you'll have a running Visionaire4 instance, a PostgreSQL database, and a Grafana dashboard in under 15 minutes.
By the end of this guide, you'll have:
a Visionaire4 node listening on port 4004, PostgreSQL on 5432, and a Grafana monitoring dashboard on 3000 — all running as Docker containers.
Prerequisites
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 of Installation) |
| 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 |
Installation Guide
Once your machine meets the requirements above, continue with the following pages in order.
Installation
Five-step Docker walkthrough for Visionaire4, PostgreSQL, and Grafana, plus bundled services and ports.
Configuration Reference
Docker flags, application arguments, env vars, and example recipes.
Next Steps
Install Dependencies
A complete guide to setting up your host machine for Visionaire4 — NVIDIA driver, Docker Engine, NVIDIA Container Toolkit, Docker Compose, and TimescaleDB.
Installation
Five-step Docker walkthrough to get Visionaire4, PostgreSQL, and Grafana running, plus the services and ports bundled in the container.