Deployment.

Deploy Aurora Gateway however fits your infrastructure — bare metal, containers, Kubernetes, or binary releases.

NPX / npm

The fastest developer path mirrors Bifrost-style startup: `iaurora` launches OSS, while `iaurora` handles full install, Enterprise artifacts, diagnostics, and service workflows.

# OSS quick start
npx -y iaurora

# Full CLI
npm install -g iaurora
aurora doctor

Docker

Use Docker for production-style local runs and container platforms. The image supports all configuration via environment variables.

docker run -d --name aurora -p 8080:8080 \ 
  -e AURORA_MASTER_KEY="your-secure-key" \ 
  -e GROQ_API_KEY="gsk_..." \ 
  aurorahq/aurora

Docker Compose

Two profiles are available:

Infrastructure only — starts Redis, Postgres, and Mongo dependencies without the gateway itself. Useful when running the gateway from source.
Full stack — starts everything including the gateway binary.

# Infrastructure only
docker compose up -d

# Full stack (gateway + infra)
docker compose --profile app up -d

Running from Source

Prerequisites: Go 1.26.2+ and a properly configured .env file.

Clone the repository: git clone https://github.com/aurorallm/aurora.git
Copy the template: cp .env.template .env
Add your provider API keys to .env
Start the server: make run

Helm Chart (Kubernetes)

For production Kubernetes deployments, Aurora provides a Helm chart that configures deployments, services, ingress, horizontal pod autoscaling, and persistent volume claims for the storage backends. The chart supports all environment variables and can be customised viavalues.yaml. See the/deploy/helm directory in the repository.

GoReleaser (Binary Releases)

Aurora uses GoReleaser to produce platform-specific binary releases for Linux, macOS, and Windows on both amd64 and arm64 architectures. Every tagged release publishes binaries to GitHub Releases along with checksums and SBOMs. This is ideal for environments where a Docker daemon is not available.

Multi-Architecture Docker Images

Docker images are built for linux/amd64 andlinux/arm64 using Docker Buildx manifests. The:latest tag automatically resolves to the correct architecture for your host, making deployment seamless on both x86 and ARM (including Apple Silicon and Graviton) environments.