System Requirements

Before installing Koios, verify that your host machine meets the following hardware and software requirements.

Single Container Architecture

Koios runs all services inside a single Docker container: the configuration database, time-series database, in-memory cache, web proxy, and the application services. The requirements below account for this all-in-one deployment.

Hardware

Resource	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	4 GB	8+ GB
Disk	20 GB free	50+ GB free

Disk usage grows over time with historical time-series data. Plan storage based on the number of tags, scan rates, and data retention settings.

Operating System

OS	Version
Ubuntu Server	20.04 LTS, 22.04 LTS, or 24.04 LTS

Ubuntu Server (minimal install) is recommended. A desktop environment is not required. Koios is managed entirely through its web interface.

Software

Dependency	Version
Docker Engine	20.10 or later

Docker is the only software dependency. See Installing Docker Engine for setup instructions.

Network

Requirement	Detail
Docker Hub access	Required to pull the Koios image (unless using an offline bundle)
Ports 443 and 80	Must be available on the host for HTTPS and HTTP access
Device network access	The host must be able to reach industrial devices (OPC-UA, Modbus, etc.) on their respective ports

Virtual Machines

If you're running Koios in a VM, use bridged networking so the container can reach devices on the local network. See Virtual Machine for details.

What's Next

Time Synchronization: keep the host clock accurate (strongly recommended)
Virtual Machine: guidance for running Koios inside a VM
Installing Ubuntu: set up the host operating system
Installing Docker Engine: install the Docker runtime

Getting Started Virtual Machine