Documentation
Learn how to install, configure, and operate the Koios platform.
Getting Started
Installation
System Requirements
Hardware and software prerequisites for running Koios
Virtual Machine
Running Koios inside a virtual machine
Installing Ubuntu
Set up the Ubuntu operating system for Koios
Installing Docker Engine
Install Docker Engine on the host system
Pulling Koios Image
Download the Koios Docker image from the registry
Running Koios as a Service
Configure Koios to run as a systemd service
Environment Variables
Configure network, performance, logging, authentication, and reverse proxy settings
Manually Starting Koios
Start Koios manually via Docker commands
Licensing Koios
Activate and manage your Koios license
Backing Up Docker Volumes
Back up and restore Koios Docker volumes
Updates
Protocols
Devices
Device Introduction
Overview of device connections in Koios
Creating a Device
General steps for creating a new device
Creating an OPC-UA Device
Configure a connection to an OPC-UA server
Creating a Modbus TCP Device
Configure a connection to a Modbus TCP device
Creating an EtherNet/IP Device
Configure a connection to an EtherNet/IP Logix controller or Generic CIP device
Creating a Microsoft SQL Device
Configure a connection to a Microsoft SQL database
Creating a REST Device
Configure a connection to a REST API device
Creating a SOAP Device
Configure a connection to a SOAP web service
Importing & Exporting Devices
Bulk import devices from CSV and export device data
On-Demand Scanning
Configure device-side on-demand read and write settings for AI model synchronization
Device Parameters
Protocol-specific device configuration parameters
Troubleshooting a Device
How to diagnose and resolve device errors
Tags
Tag Introduction
Overview of tags and data points in Koios
Creating a Tag
General steps for creating a new tag
Creating an OPC-UA Tag
Configure an OPC-UA node as a tag
Creating a Modbus TCP Tag
Configure a Modbus register as a tag
Creating an EtherNet/IP Tag
Configure tags for Logix controllers and Generic CIP devices
Creating a Microsoft SQL Tag
Configure a SQL column as a tag
Creating a REST Tag
Configure a BOSS variable as a tag
Creating a SOAP Tag
Configure a SOAP field as a tag
Expression Tags
Create calculated tags using mathematical expressions, tag references, and built-in functions
Importing & Exporting Tags
Bulk import tags from CSV and export tag data
Value Mapping
Map raw device values to numeric outputs using ordered match rules
Troubleshooting a Tag
How to diagnose and resolve tag errors
Models
Model Introduction
Overview of AI models in Koios
Training a Model
Understand where model training fits in the Koios workflow and what you need before deploying
Model Inference Requirements
Requirements for running model inference
Creating a Model
Create a new AI model in Koios
Managing Model Files
Upload and manage ONNX and TFLite model files
Assigning Bindings
Bind model inputs and outputs to tags
Configuring a Model
Detailed guide to all model configuration settings
On-Demand Inference
Synchronize model inference with fresh device data using on-demand reads and writes
Scan Groups
Group models for synchronized execution with shared on-demand reads and writes
Importing & Exporting Models
Bulk import and export AI model and binding configurations as CSV
Monitoring a Model
View live inference values, binding diagnostics, execution performance, and historical trends
Troubleshooting a Model
How to diagnose and resolve model and binding errors
Trends
Components
Components
Overview of the component system — libraries, environments, instances, and wiring
Component Libraries
Upload, activate, version, and manage component library packages
Component Environments
Create and configure execution environments for component instances
Component Canvas
Add component instances, wire inputs and outputs, and monitor live execution
Building Components
Overview of developing custom components with the Koios Component Builder
Release Notes
v1.1.0
Calibrated bindings, flat-model support, richer canvas wiring, per-instance pin layouts, and structured wire validation
v1.0.2
Patch release — model-history gaps for in-memory inputs, model upload validation, UI polish
v1.0.1
Patch release — fixes duplicate scheduling chains in the data collector and predict engine
v1.0.0
What's new in Koios v1.0.0 — custom components, expression tags, a redesigned interface, and much more
System
System Overview
View platform version, server health, system information, and server time
License
View license status, details, and re-activate when needed
Users
Create and manage user accounts, assign roles, and control access
Roles & Permissions
Create roles, assign permissions, and control what users can do
API Clients
Manage API client credentials for external system integrations
Backup & Restore
Create, schedule, and restore system backups
Data Retention
Configure storage monitoring, history compression, and automatic cleanup policies
Services
Monitor platform service status and control service lifecycle
System Health
Monitor CPU, memory, and disk usage with configurable alarms
Network
Scan and discover hosts on your plant network, view interface details, and run diagnostic tools
Logs
Stream real-time service logs and browse archived log files