Ai-OPs
// Home// About// Platform// Marketplace// Developer// Support// License
// Portal
Docs
/
Admin Console
/

Managing Instances

Managing Instances

Once the console is running, you connect your Koios boxes to it and monitor them from the fleet dashboard.

Connect an Instance

From the Instances page, choose Connect a Koios and provide the box's address and an administrator login for it. The console then:

  1. Connects to the box and pins its certificate.
  2. Mints a scoped, read-only access token on the box for ongoing polling.
  3. Seals that token under the master key and begins tracking the instance.

The credentials step also has an Allow remote license upload switch, on by default. Leave it on to push .lic files to the box from the console later. Turn it off to keep the instance status-only, in which case the later license push is unavailable.

The box appears in the fleet within a few seconds. You can optionally assign it to a group to organize instances by site, customer, or role. If several boxes run on the same host, see Running Multiple Instances for how to set them up on distinct ports.

The Fleet Dashboard

The Instances page lists every registered box with its live status:

  • Status: reachability refined by health. A box reads as one of Online, Degraded (a service down, an alarm firing, or failing devices/tags/models), Unreachable, Auth failed, or Version unsupported (the box version is outside the supported range).
  • Version, License, and Last seen.

The summary tiles across the top (Total, Online, Degraded, Offline, License issues) double as filters, so selecting one narrows the list, and the search box filters by name or host. The whole view refreshes automatically.

Inspect an Instance

Select a row to open its detail page, which shows:

  • Services: each Koios service and whether it is running, stopped, or failed.
  • Alarms and failures: active CPU, RAM, storage, or network alarms, and counts of failing devices, tags, models, and scan groups.
  • License: state, days remaining, and the licensed hardware.

Manage Licenses

For any instance whose license you can see, the detail page shows its current state and days remaining. Where a box is opted into remote upload, you can push a new .lic file to it directly from the console: select the license upload control on the instance's detail page and choose the file. The box applies it without needing a separate sign-in.

The License issues filter on the Instances page surfaces every box whose license is expired, in a grace period, expiring soon, or invalid, which is a quick way to catch renewals before they lapse.

What's next

The console manages boxes running the full Koios platform. To work inside an instance, see:

Running as a Service