Deploy

a10y runs on Kubernetes (production) or Docker Compose (local development).

Architecture

Dashboards (Data Layer UIs)

After deployment, the Data Layer components provide built-in dashboards out of the box. These are the primary interfaces for day-to-day operations.

Kubernetes (Helm)

Prerequisites

• Kubernetes 1.28+
• Helm 3.12+
• Storage class with dynamic provisioning (for OpenObserve, Qdrant)
• Anthropic API key (for correlation-engine)

Quick Start

# Add the a10y chart repo
helm repo add a10y https://autonomously-io.github.io/charts
helm repo update

# Create namespace and secret
kubectl create namespace a10y
kubectl -n a10y create secret generic correlation-engine-secrets \
  --from-literal=ANTHROPIC_API_KEY=sk-ant-...

# Install
helm install a10y a10y/autonomously -n a10y

Custom Values

# values-prod.yaml
components:
  correlation-engine:
    env:
      AI_MODEL: "claude-sonnet-4-20250514"
    resources:
      requests:
        cpu: "1"
        memory: 2Gi

  aether-ide:
    ingress:
      enabled: true
      host: ide.a10y.example.com

openobserve:
  auth:
    ZO_ROOT_USER_EMAIL: "admin@example.com"
    ZO_ROOT_USER_PASSWORD: "your-secure-password"
  persistence:
    size: 500Gi

qdrant:
  persistence:
    size: 50Gi

# Install with custom values
# helm install a10y a10y/autonomously -n a10y -f values-prod.yaml

Disable Components

# Minimal install (engine + data layer only, no UI)
helm install a10y a10y/autonomously -n a10y \
  --set components.aether-ide.enabled=false \
  --set components.aether-term.enabled=false

Docker Compose

Prerequisites

• Docker 24+ & Docker Compose v2
• 8 GB+ RAM available
• Anthropic API key

Setup

# Clone
git clone https://github.com/autonomously-io/autonomously-io.github.io.git a10y
cd a10y

# Configure
cp .env.example .env
# Edit .env and set ANTHROPIC_API_KEY

# Start all services
docker compose up -d

# Check status
docker compose ps

# View logs
docker compose logs -f correlation-engine

docker-compose.yml

services:
  # -- Core
  correlation-engine:
    image: ghcr.io/autonomously-io/correlation-engine:latest
    ports: ["8000:8000"]
    environment:
      AI_MODEL: claude-sonnet-4-20250514
      OPENOBSERVE_URL: http://openobserve:5080
      OPENOBSERVE_USER: admin@a10y.local
      KEEP_API_URL: http://keep-backend:8080
      NATS_URL: nats://nats:4222
      QDRANT_URL: http://qdrant:6333
      QDRANT_COLLECTION: incidents
      INVENTORY_URL: http://active-inventory:8080
      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
    depends_on: [openobserve, keep-backend, nats, qdrant]

  active-inventory:
    image: ghcr.io/autonomously-io/active-inventory:latest
    ports: ["8081:8080"]

  # -- UI
  aether-ide:
    image: ghcr.io/autonomously-io/aether-ide:latest
    ports: ["8080:8080"]
    environment:
      CORRELATION_ENGINE_URL: http://correlation-engine:8000

  aether-term:
    image: ghcr.io/autonomously-io/aether-term:latest
    ports: ["3000:3000"]
    environment:
      CORRELATION_ENGINE_URL: http://correlation-engine:8000

  # -- Data layer
  openobserve:
    image: public.ecr.aws/zinclabs/openobserve:latest
    ports: ["5080:5080"]
    environment:
      ZO_ROOT_USER_EMAIL: admin@a10y.local
      ZO_ROOT_USER_PASSWORD: changeme
      ZO_LOCAL_MODE: "true"
    volumes: ["openobserve-data:/data"]

  keep-backend:
    image: us-central1-docker.pkg.dev/keephq/keep/keep-api:latest
    ports: ["8082:8080"]

  keep-frontend:
    image: us-central1-docker.pkg.dev/keephq/keep/keep-ui:latest
    ports: ["3001:3000"]
    environment:
      API_URL: http://keep-backend:8080

  nats:
    image: nats:2-alpine
    ports: ["4222:4222", "8222:8222"]
    command: ["--js", "--sd", "/data", "-m", "8222"]
    volumes: ["nats-data:/data"]

  qdrant:
    image: qdrant/qdrant:latest
    ports: ["6333:6333"]
    volumes: ["qdrant-data:/qdrant/storage"]

  vector:
    image: timberio/vector:0.41.1-alpine
    ports: ["9000:9000", "6514:6514"]
    volumes: ["./vector.yaml:/etc/vector/vector.yaml:ro"]
    depends_on: [openobserve]

volumes:
  openobserve-data:
  nats-data:
  qdrant-data:

.env.example

ANTHROPIC_API_KEY=sk-ant-your-key-here

Log Forwarding

a10y ingests logs via Vector. Two input protocols are supported:

# rsyslog
*.* @@vector-host:9000

# syslog-ng
destination d_a10y {
  tcp("vector-host" port(9000));
};

# vector.yaml (agent)
sinks:
  a10y:
    type: vector
    address: "vector-host:6514"
    version: "2"

Supported Sources