Installing the Admin Console

The Admin Console runs as a single Docker container. Docker Engine must be installed first. See Installing Docker Engine if you haven't done this yet.

Run the Container

Start the console with a single command:

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

This pulls the image, creates the two data volumes if they don't exist, and serves the console over HTTPS on port 443 (plain HTTP on port 80 redirects to it). Using :latest is convenient for evaluation; for production, pin a specific version tag such as aiopinc/koios-admin:1.0.0 so upgrades are intentional.

First Access

Open a browser and navigate to the host:

https://<server-ip>

Your browser will show a warning for the self-signed certificate generated on first boot. This is expected. Accept it to proceed, then log in with the default credentials:

Username: admin
Password: koios

Change the default password

You are prompted to set a new password on first login. Do this immediately.

Data Volumes

The console stores everything in two named volumes that persist independently of the container:

Volume	Contents
`koios_admin_data`	Configuration database and TLS certificate
`koios_admin_secrets`	Master encryption key

Docker creates them automatically on first start.

The secrets volume must persist

The koios_admin_secrets volume holds the master key that seals every registered instance's connection credentials. If it is lost or recreated, the console can no longer decrypt those credentials and each instance must be reconnected. Always keep this volume, and include it in your backups.

What's next

Running as a Service: start the console automatically on boot
Managing Instances: connect your first Koios box

Admin Console Running as a Service