Docker Deployment Guide

Integra is distributed as a lightweight, production-ready Docker container.

Quick Start

Run the latest version from AWS Marketplace/ECR:

docker pull priyaiosystems/integra:latest
docker run -d -p 8080:8080 priyaiosystems/integra:latest

The API will be available at http://localhost:8080.

Configuration

Configure the container using environment variables.

Variable	Default	Description
`INTEGRA_PORT`	`8080`	Port to listen on.
`INTEGRA_LOG_LEVEL`	`info`	Log level: `debug`, `info`, `warn`, `error`.
`INTEGRA_TELEMETRY_ENABLED`	`false`	Enable OpenTelemetry tracing.
`OTEL_EXPORTER_OTLP_ENDPOINT`	`localhost:4318`	OTLP collector endpoint.
`GOMEMLIMIT`	-	Go runtime memory limit (recommended for container limits).
`GOMAXPROCS`	-	CPU core limit (auto-detected if unset).

Example: Custom Port & Logging

docker run -d \
  -p 9090:9090 \
  -e INTEGRA_PORT=9090 \
  -e INTEGRA_LOG_LEVEL=debug \
  priyaiosystems/integra:latest

Resource Limits

Integra is highly efficient. Recommended limits for production:

CPU: 0.5 vCPU (Baseline), 2.0 vCPU (Burstable)
Memory: 128MB (Baseline), 512MB (Max)

docker run -d \
  -p 8080:8080 \
  --cpus=0.5 \
  --memory=256m \
  priyaiosystems/integra:latest

Health Checks

Integra provides a /health endpoint for orchestrators.

Docker Compose Example:

services:
  integra:
    image: priyaiosystems/integra:latest
    ports:
      - "8080:8080"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 5s
      retries: 3