Configuration

Docker Compose

Deploy the complete Hyperion infrastructure including the semantic search engine, analytics layer, and audit storage in a single command.

01 — INFRASTRUCTURE

The Core Stack

Hyperion requires Redis (L1), Qdrant (L2), ClickHouse (Analytics), and Postgres (Metadata) to operate at full capacity.

02 — SETUP

Secrets & .env

Copy .env.example to .env and generate your master secrets (ADMIN_API_KEY, CACHE_MASTER_SECRET).

03 — ORCHESTRATION

Production Build

The gateway builds from source by default. Use 'docker compose up --build' for the first run.

04 — STORAGE

Persistent Volumes

Data is persisted across restarts via named volumes for Postgres, Redis, and Qdrant.

Example Specification

This condensed specification shows the required services. See the root docker-compose.yml for the full configuration.

version: '3.8'

services:
  gateway:
    image: hyperion-ai/gateway:latest
    ports: ["8080:8080"]
    env_file: [.env]
    depends_on: [redis, postgres, qdrant, clickhouse]

  redis:
    image: redis:7-alpine
    container_name: hyperion-redis

  postgres:
    image: postgres:16-alpine
    container_name: hyperion-postgres
    environment:
      POSTGRES_DB: hyperion_db
      POSTGRES_PASSWORD: your_password

  qdrant:
    image: qdrant/qdrant:latest
    container_name: hyperion-qdrant

  clickhouse:
    image: clickhouse/clickhouse-server:24.1
    container_name: hyperion-clickhouse