Installation

Prerequisites

Go 1.27 (for building from source)
Docker (alternative)

Build from Source

git clone https://github.com/MiXaiLL76/auto_ai_router.git
cd auto_ai_router
go build -o auto_ai_router ./cmd/server/

Run with a config file:

./auto_ai_router -config config.yaml

Docker

Build locally

docker build -t auto-ai-router:latest .
docker run -p 8080:8080 -v $(pwd)/config.yaml:/app/config.yaml auto-ai-router:latest

Pull from GHCR

docker pull ghcr.io/mixaill76/auto_ai_router:latest
docker run -p 8080:8080 -v $(pwd)/config.yaml:/app/config.yaml ghcr.io/mixaill76/auto_ai_router:latest

Docker Compose

Create a docker-compose.yml:

version: '3.8'

services:
  auto-ai-router:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: auto-ai-router
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/app/config.yaml:ro
      - ./logs:/app/logs
    environment:
      - LOG_LEVEL=debug
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "/app/healthcheck"]
      interval: 30s
      timeout: 3s
      retries: 3
      start_period: 5s
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

Then run:

docker-compose up -d

Runtime user and persistent data

If you mount a volume at /data/auto_ai_router, it must be writable by uid 65532:

# Kubernetes
securityContext:
  fsGroup: 65532

# Docker / compose bind mount
chown -R 65532:65532 ./data

Non-default port

HEALTHCHECK runs /app/healthcheck, which probes http://localhost:8080/health by default. If you override server.port, set the matching env var or the container will report unhealthy while the server is actually fine:

docker run -e HEALTHCHECK_PORT=9090 ...
# or, when the whole URL differs:
docker run -e HEALTHCHECK_URL=http://127.0.0.1:9090/health ...

Verify

Check that the router is running:

curl http://localhost:8080/health