---
title: "System Requirements"
description: "Hardware and software prerequisites for running Koios"
source_url: https://ai-ops.com/docs/installation/system-requirements
---

# System Requirements

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

> [!NOTE] 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](https://ai-ops.com/docs/installation/installing-docker.md) 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 |

> [!TIP] 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](https://ai-ops.com/docs/installation/virtual-machine.md) for details.

## What's Next

- [Time Synchronization](https://ai-ops.com/docs/installation/time-synchronization.md): keep the host clock accurate (strongly recommended)
- [Virtual Machine](https://ai-ops.com/docs/installation/virtual-machine.md): guidance for running Koios inside a VM
- [Installing Ubuntu](https://ai-ops.com/docs/installation/installing-ubuntu.md): set up the host operating system
- [Installing Docker Engine](https://ai-ops.com/docs/installation/installing-docker.md): install the Docker runtime