---
title: "Managing Instances"
description: "Connect Koios boxes, monitor fleet health, and manage licenses"
source_url: https://ai-ops.com/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](https://ai-ops.com/docs/installation/running-multiple-instances.md) for how to set them up on distinct ports.

> [!NOTE] Read-only by default
> Registered instances are monitored read-only. Actions that change a box, such as pushing a license, are only available when that box has been opted into remote license upload.

## 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:

- [Licensing Koios](https://ai-ops.com/docs/installation/licensing.md) for the on-box license activation flow behind the remote push.
- [Getting Started](https://ai-ops.com/docs/getting-started/introduction.md) for the platform each instance runs.