---
title: "Installing the Admin Console"
description: "Pull the Koios Admin Console image and run it"
source_url: https://ai-ops.com/docs/admin-console/installation
---

# Installing the Admin Console

The Admin Console runs as a single Docker container. Docker Engine must be installed first. See [Installing Docker Engine](https://ai-ops.com/docs/installation/installing-docker.md) if you haven't done this yet.

## Run the Container

Start the console with a single command:

```bash
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:

```text
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`

> [!CAUTION] 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.

> [!WARNING] 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](https://ai-ops.com/docs/admin-console/running-as-a-service.md): start the console automatically on boot
- [Managing Instances](https://ai-ops.com/docs/admin-console/managing-instances.md): connect your first Koios box