QUBIQ User Manual
QUBIQ is an AI-powered IIoT / SCADA platform for unified industrial data. It connects to plant equipment over industrial protocols, models that equipment as a tag namespace, moves and transforms data through pipelines, stores history, raises alarms, and presents everything on operator screens you build in a browser — from one lightweight stack.
This manual is the reference for installing, configuring and operating QUBIQ.
Read What is QUBIQ? for the ten-minute mental model, then follow Installation and build your first screen in Quick Start.
Choose your path
| I want to… | Start here |
|---|---|
| Understand what QUBIQ is and how it fits together | What is QUBIQ? · Architecture |
| Get it running on a machine | System requirements → Installation → First-run setup |
| Connect to a PLC, broker or database | Connections |
| Model my plant as tags | Namespace & Tags |
| Move and transform data | Pipelines |
| Build an operator screen | Designer · Components |
| Alarm on a process value | Alarms |
| Trend and store history | Historian |
| Write scripts | Scripting |
| Lock the system down | Security |
| Run it in production | Administration |
| Send my tags to another system | MQTT publishing |
| Find something, or see what an edit will break | Search & impact |
| Work out what this installation is licensed for | Licensing & modules |
| Decide what the AI assistant is allowed to do | AI skills & fences |
How this manual is organized
The manual follows the Diátaxis model: each page is deliberately one of four kinds, and the section it lives in tells you which.
| Section | What's inside | Kind |
|---|---|---|
| Getting Started | Install QUBIQ and get to a working first project. | Tutorial |
| Platform | How the system is built: gateway, services, projects, data flow. | Explanation |
| Connections | Every protocol and data source, field by field. | How-to + reference |
| Namespace & Tags | Tags, protocol bindings, UDTs, bulk import. | How-to + reference |
| Pipelines | Node-based data flows and their execution model. | How-to + reference |
| Designer | Views, layout, bindings, event actions, LiveView. | How-to + reference |
| Components | Every widget, drawing tool and symbol. | Reference |
| Scripting | The system API in Python and JavaScript. | Reference |
| Alarms | ISA-18.2 alarm configuration and operation. | How-to + reference |
| Historian | Time-series storage, retention and queries. | How-to + reference |
| Security | Users, roles, permissions, API keys, audit. | How-to + reference |
| Administration | Services, settings, backup, logs. | How-to |
| Tutorials | End-to-end walkthroughs of real tasks. | Tutorial |
| Appendix | REST API, permissions, expression functions, glossary. | Reference |
| What's New | Changes in the current release. | — |
Finding your way
- The left sidebar is the full table of contents; sections stay expanded as you read.
- The search box (top right) indexes every page — search for a tag property, a node type, a permission key or an API path.
- The version selector (top right) names the QUBIQ release this manual documents.
- A New in 1.0.4 badge marks something that arrived in a particular release, so you can tell whether it exists on the version you are running.
Conventions used in this manual
| Convention | Meaning |
|---|---|
Settings → Connections | A path through the QUBIQ user interface. |
| View the namespace | A permission key. |
system.tag.read(...) | A scripting API call. |
Plant/Line1/Motor1/Speed | A tag path in the namespace. |
| Note / Tip / Warning callouts | Supporting detail, a shortcut, and something that can bite you. |
| New in 1.0.4 | The release this capability arrived in. No badge means it predates 1.0.0. |
This manual documents QUBIQ 1.0.4. If a screen in your install does not match, check the version selector and What's New, which lists what arrived in each release of the 1.0 series.