System Requirements

Hardware and software prerequisites for running Konnect.

Minimum requirements

Component	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	4 GB	8 GB
Disk	10 GB free	20 GB free
Docker	24.0+	Latest stable
OS	Linux, macOS, or Windows (with Linux containers)	Linux (Ubuntu 22.04+)

Supported browsers

Konnect is a web application accessed through a browser. The following browsers are supported:

Browser	Minimum Version
Google Chrome	120+
Mozilla Firefox	120+
Apple Safari	17+
Microsoft Edge	120+

Note: Konnect is a Progressive Web App (PWA). You can install it as a standalone application on desktop and mobile devices for quick access.

Network requirements

Service	Port	Protocol	Direction
Konnect web UI	8080 (configurable)	HTTP/HTTPS	Inbound
LLM API providers	443	HTTPS	Outbound
MQTT brokers	1883 / 8883	MQTT / MQTTS	Outbound
OPC-UA servers	4840 (configurable)	OPC-UA TCP	Outbound
SQL databases	Varies (5432, 3306, 1433)	TCP	Outbound
Ollama (optional)	11434	HTTP	Outbound

Firewall considerations

Konnect needs outbound access to your LLM provider’s API (Groq, OpenAI, or Anthropic) unless you’re using a self-hosted Ollama instance.
Konnect needs network access to any MQTT brokers, OPC-UA servers, and databases you want to connect.
If running behind a reverse proxy, ensure WebSocket connections are supported (used for real-time data streaming).

Docker requirements

Konnect runs as a Linux container via Docker. It works on Windows, macOS, and Linux — Docker handles the virtualisation.

Windows Server 2022 / Windows Desktop: Docker must be set to Linux container mode (not Windows containers). If you see a “no matching manifest for windows/amd64” error, see Troubleshooting.

# Check Docker version
docker --version

# Check Docker is running
docker info

Docker Compose (optional)

For multi-service deployments (Konnect + MQTT broker + database):

# Check Docker Compose version
docker compose version

Docker Compose V2 (integrated into Docker CLI) is recommended.

Deployment platforms

Konnect is a Linux container. The simplest deployment path is always a Linux VM or managed container service. Windows Server works but requires additional setup.

Operating system comparison

OS	Docker Setup	Complexity	Recommended?
Ubuntu 22.04+ / Debian	`apt install docker.io`	✅ Simplest	✅ Recommended
Amazon Linux 2023	`yum install docker`	✅ Simple	✅ Yes
RHEL / CentOS / Rocky	`yum install docker-ce`	✅ Simple	✅ Yes
macOS (Desktop)	Docker Desktop	✅ Simple	✅ Yes (dev/testing)
Windows 10/11 (Desktop)	Docker Desktop (WSL2)	⚠️ Moderate	⚠️ Dev only
Windows Server 2022	Docker Desktop + Hyper-V	❌ Complex	❌ Avoid if possible
Windows Server 2019	Docker Desktop + Hyper-V	❌ Complex	❌ Avoid if possible

Why avoid Windows Server? Docker Desktop on Windows Server requires nested virtualisation (Hyper-V), which is only available on certain VM sizes. Linux VMs run Docker natively with no extra virtualisation layer — simpler, cheaper, and more reliable. See Troubleshooting for common Windows issues.

Microsoft Azure

Option	VM / Service	vCPUs	RAM	Notes
✅ Linux VM (recommended)	`Standard_D2s_v5`	2	8 GB	Ubuntu 22.04. Cheapest and simplest.
✅ Linux VM (team)	`Standard_D4s_v5`	4	16 GB	For multiple users or data sources.
✅ Azure Container Instances	—	2+	4+ GB	Managed containers, no VM to maintain.
✅ Azure Container Apps	—	2+	4+ GB	Managed, scales to zero.
⚠️ Windows Server VM	`Standard_D4s_v3` or newer	4+	16+ GB	Requires v3 or newer series for nested virtualisation. B-series and v2 will not work.

Azure tip: If you must use Windows Server, ensure the VM size supports nested virtualisation — Dv3, Dv4, Dv5, Ev3, Ev4, Ev5 series. B-series and Dv2 do not support it and Docker Desktop will fail.

Amazon Web Services (AWS)

Option	Instance / Service	vCPUs	RAM	Notes
✅ Linux EC2 (recommended)	`t3.medium`	2	4 GB	Amazon Linux 2023 or Ubuntu 22.04.
✅ Linux EC2 (team)	`t3.large`	2	8 GB	For multiple users or data sources.
✅ ECS on Fargate	—	2+	4+ GB	Managed containers, no server to manage.
✅ ECS on EC2	`t3.medium`+	2+	4+ GB	Self-managed container cluster.
⚠️ Windows EC2	`.metal` instances only	Varies	Varies	Nested virtualisation only on bare-metal. Expensive — avoid.

AWS tip: Use a Linux EC2 instance or ECS Fargate. Windows EC2 instances require bare-metal (.metal) instance types for Docker Desktop, which are significantly more expensive.

Google Cloud Platform (GCP)

Option	Machine Type / Service	vCPUs	RAM	Notes
✅ Linux VM (recommended)	`e2-medium`	2	4 GB	Ubuntu 22.04 or Debian.
✅ Linux VM (team)	`e2-standard-4`	4	16 GB	For multiple users or data sources.
✅ Cloud Run	—	2+	4+ GB	Managed containers, scales to zero.
✅ GKE	`e2-medium`+	2+	4+ GB	Kubernetes cluster for advanced deployments.
⚠️ Windows VM	`n1-standard-4`+	4+	15+ GB	Requires nested virtualisation enabled on the VM. Must explicitly enable in GCP console.

GCP tip: Use a Linux VM or Cloud Run. If you need Windows, you must enable nested virtualisation manually when creating the VM (--enable-nested-virtualization flag) — it is off by default.

On-premises / self-hosted

Platform	Setup	Notes
Linux server	Install Docker Engine	Simplest path. Any modern Linux distro.
macOS workstation	Docker Desktop	Good for development and testing.
Windows workstation	Docker Desktop + WSL2	Works well for development.
Windows Server	Docker Desktop + Hyper-V	Requires hardware virtualisation support. Check BIOS/UEFI settings.
Proxmox / VMware / Hyper-V VM	Linux guest VM	Run a Linux VM inside your hypervisor, then install Docker.

Resource scaling

For larger deployments with many concurrent users or data sources:

Scenario	CPU	RAM	Notes
Single user, 1-2 data sources	2 cores	4 GB	Minimum viable setup
Small team, 3-5 data sources	4 cores	8 GB	Recommended for most teams
Large deployment, 10+ data sources	8+ cores	16+ GB	Consider dedicated database hosting

Next steps

Installation → — Set up Konnect with Docker.
Configuration → — Docker setup, LLM providers, and data connections.
Troubleshooting → — Common installation and connection issues.