aiopinc/koios repository overview

⁠Koios

Ai-OPs IoT platform for industrial environments. Koios connects directly to OT devices, collects data in real time, and runs on-device AI/ML inference at the edge — all on-premises, so data never has to leave your site.

• Data ingress/egress - OPC-UA, Modbus TCP, EtherNet/IP, ODBC
• AI inference - run ONNX and TensorFlow Lite models on live data
• Edge deployment - one self-contained container; no cloud dependency
• Python Components - Create your own Python components using Koios Component Builder⁠ and let them interact with your facility

Full documentation: https://ai-ops.com/docs⁠

⁠Quick start

Koios is a single monolithic container that bundles the configuration database, time-series database, in-memory cache, web proxy, and all application services. Docker creates any missing named volumes automatically.

docker run -d --name koios --network host \
  --mount source=koios_data_postgres,target=/var/lib/postgresql/16/main \
  --mount source=koios_data_influxdb,target=/root/.influxdbv2 \
  --mount source=koios_media,target=/var/www/koios/media \
  --mount source=koios_logs,target=/var/www/koios/logs \
  --mount source=koios_certs,target=/var/www/koios/certs \
  --mount source=koios_license,target=/var/www/koios/license \
  --mount source=koios_secrets,target=/var/www/koios/secrets \
  aiopinc/koios:latest

Then open https://<server-ip> and log in:

• Username: admin
• Password: koios

⁠Ports

Run with --network host (recommended) so the container can reach industrial devices directly on the host network.

Prefer explicit mapping? Replace --network host with -p 443:443 -p 80:80 (you may then need extra -p flags for device protocol ports).

⁠Volumes

All data lives in seven named volumes that persist across restarts, updates, and re-deployments. Include all seven in your backups.

⁠Requirements

Host: Ubuntu Server 20.04 / 22.04 / 24.04 LTS · Docker Engine 20.10+ · NTP-synced clock (required — Koios timestamps all data using the host clock).

⁠Documentation

© Ai-OPs, Inc. · Koios is licensed software. Contact your Ai-OPs representative for a license key.