aiopinc/koios-admin repository overview

⁠Koios Admin Console

Manage a fleet of Koios instances from one place. The Admin Console is a lightweight, on-prem web app that gives you a single view of service health, failures, and license state across every Koios box you run, plus remote .lic upload. It ships as one small container, separate from the main Koios image.

• Fleet overview - reachability, service state, alarms, and failing devices/tags/models for every box, live
• License management - each instance's license state and days remaining, plus push a .lic file to a box remotely
• Secure by design - the browser never holds a box credential; access is read-only unless a box is opted into control
• One image - web UI, API, and poller in a single self-contained container

Full documentation: https://ai-ops.com/docs/admin-console/introduction⁠

⁠Quick start

The Admin Console runs alongside your Koios boxes on the same network. Docker creates any missing named volumes automatically.

docker run -d --name koios-admin \
  -p 443:443 -p 80:80 \
  -v koios_admin_data:/var/lib/koios-admin \
  -v koios_admin_secrets:/var/lib/koios-admin-secrets \
  -e ENABLE_TLS=true \
  aiopinc/koios-admin:latest

Then open https://<server-ip> (accept the self-signed certificate) and log in:

• Username: admin
• Password: koios

⁠Ports

To serve behind a reverse-proxy sub-path, set KOIOS_ADMIN_BASE_PATH (the proxy must strip the prefix). See Running as a Service⁠.

⁠Volumes

Two named volumes persist across restarts and updates. Include both in your backups.

⁠Requirements

Host: Docker Engine 20.10+. Multi-arch image (linux/amd64, linux/arm64).

⁠Documentation

© Ai-OPs, Inc.