Admin Console

The Koios Admin Console is a lightweight, on-prem web app for managing many Koios instances from one place. Instead of logging into each box individually, you get a single fleet view of service health and failures, plus license state and remote .lic upload for every instance you register.

It ships as its own small Docker image (aiopinc/koios-admin), separate from the main Koios container, and runs alongside your instances on the same network.

What it gives you

• Fleet overview: reachability, service state, active alarms, and failing devices, tags, models, and scan groups for every box, refreshed live.
• License management: each instance's license state and days remaining, plus the ability to push a .lic file to a box remotely.
• One place to look: a single sign-in and a single dashboard for as many Koios boxes as you run.

How it works

• Backend proxy: the browser never holds a box's credentials. Every call to an instance is proxied through the console's backend, which connects using a scoped, read-only access token minted on that box.
• Single poller: one background process checks each registered instance on a tiered schedule and caches the results, so the dashboard stays fast and the boxes aren't hammered.
• Sealed credentials: each instance's connection secret is encrypted under a master key kept on a dedicated volume, separate from the configuration data.

The Admin Console is for fleet-level monitoring and licensing: connecting instances, watching health, and pushing licenses. To configure a specific box's devices, tags, or models, use that box's own Koios interface. The rest of this documentation covers the platform running on each instance.

When to use it

Reach for the Admin Console when you operate more than one or two Koios boxes and want a consolidated view of their health and licensing, for example across a site, a plant, or several customers. To run several boxes on one host, see Running Multiple Instances.

What's next

• Installing the Admin Console: pull the image and run it
• Running as a Service: start it automatically on boot
• Managing Instances: connect boxes and manage licenses