---
title: "Admin Console"
description: "Manage a fleet of Koios instances from one place: health, failures, and licenses"
source_url: https://ai-ops.com/docs/admin-console/introduction
---

# 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](https://ai-ops.com/docs/installation/running-multiple-instances.md).

## What's next

- [Installing the Admin Console](https://ai-ops.com/docs/admin-console/installation.md): pull the image and run it
- [Running as a Service](https://ai-ops.com/docs/admin-console/running-as-a-service.md): start it automatically on boot
- [Managing Instances](https://ai-ops.com/docs/admin-console/managing-instances.md): connect boxes and manage licenses