Ensure your infrastructure meets these requirements before deploying the Dreadnode platform for production use.
Hardware Requirements
These recommendations are for a standard single-node Docker deployment running the full stack (API, UI, Postgres, ClickHouse).
| Component | Minimum | Recommended | Notes |
|---|
| CPU | 2 vCPU | 4+ vCPU | Agent evaluations can be compute-intensive. |
| RAM | 4 GB | 8+ GB | ClickHouse and Postgres require sufficient memory for performance. |
| Disk | 20 GB | 100+ GB SSD | Storage needs grow with the volume of evaluation logs and artifacts. |
Data Storage: The platform uses Docker Volumes for data persistence. Ensure the partition hosting /var/lib/docker (or your configured Docker root) has sufficient space.
Software Requirements
| Category | Requirements |
|---|
| Operating System | Linux (Ubuntu 20.04+, RHEL 8+, Debian 11+) or macOS (12+). |
| Container Runtime | Docker Engine 20.10+ or Docker Desktop 4.0+. |
| Orchestrator | Docker Compose V2 (bundled with modern Docker Desktop/CLI). |
| CLI | Python 3.10+ (for the dreadnode SDK). |
Windows Support: Native Windows is not supported. Use WSL2 (Windows Subsystem for Linux) with Docker Desktop.
Network Requirements
The platform consists of several services that communicate internally via a Docker network. You only need to expose specific ports to your users.
Inbound Ports
| Port (Default) | Protocol | Service | Description |
|---|
| 80 | TCP | UI | The web dashboard. |
| 8080 | TCP | API | The backend API used by the UI and SDK. |
TLS/SSL: The platform containers speak HTTP. For production, we strongly recommend deploying a reverse proxy (Nginx, Caddy, AWS ALB) in front of the platform to handle HTTPS/TLS termination.
Outbound Connectivity
The platform requires outbound access to the following services during installation and operation:
| Destination | Port | Purpose |
|---|
index.docker.io | 443 | Pulling public base images. |
registry.dreadnode.io | 443 | Pulling private Dreadnode application images. |
api.dreadnode.io | 443 | License verification and release checks. |
Air-Gapped Environments: See Manage Data for offline installation instructions.