Deployment Guide

Docker Compose (Recommended for PoC)

# Clone and start
git clone https://github.com/vaagatech/anvesh.git
cd anvesh
docker-compose up -d

# Verify
curl http://localhost:3848/health
# → {"status":"ok"}

The Docker Compose stack includes Anvesh Engine, Hub, Spider, and Bulk Indexer with all networking pre-configured.

Kubernetes / K3s

Deploy using the included manifests or Helm chart:

# Apply K8s manifests
kubectl apply -f k8s/namespace.yaml
kubectl apply -f k8s/

# Or with Helm
helm install anvesh ./charts/anvesh \
  --namespace anvesh \
  --create-namespace \
  --set engine.replicas=3 \
  --set storage.tier=oci

Resource Requirements

Bare Metal

Download the single Go binary for your platform:

# Linux AMD64
curl -fsSL https://github.com/vaagatech/anvesh/releases/latest/download/anvesh-linux-amd64 -o anvesh
chmod +x anvesh
./anvesh serve --config config.yaml

# Linux ARM64
curl -fsSL https://github.com/vaagatech/anvesh/releases/latest/download/anvesh-linux-arm64 -o anvesh
chmod +x anvesh
./anvesh serve --config config.yaml

Configuration

Key configuration options in config.yaml:

server:
  port: 3848
  host: 0.0.0.0

storage:
  data_dir: /var/anvesh/data
  tier: oci              # or s3, local
  bucket: anvesh-warm
  endpoint: https://objectstorage.us-ashburn-1.oraclecloud.com

cluster:
  mode: distributed      # or standalone
  replication_factor: 2

dlq:
  enabled: true
  max_retries: 5
  retry_interval: 30s

Health & Monitoring

• GET /health — basic health check
• GET /metrics — Prometheus-compatible metrics endpoint
• GET /v1/cluster/status — cluster topology and shard state