Skip to main content

​
Installation Guide

This section covers everything needed to get Decision Engine running locally — from a single docker compose up to the full CLI, Docker, Compose, and Helm matrix.

​
Prerequisites

The Quick Start below pulls prebuilt images from GHCR, so you do not need Rust, make, or a local database. You do need:
  • Docker Engine 20+
  • Docker Compose v2+ (the docker compose subcommand, not the legacy docker-compose binary)
  • The repository cloned locally — the compose command reads docker-compose.yaml, so run it from the repo root:
  • Network access to pull ghcr.io/juspay/... images and a few GB of free disk (the first run pulls the app, PostgreSQL, Redis, Kafka, ClickHouse, and Mailpit).

​
Quick Start

The fastest path to a running instance. Every service in docker-compose.yaml is gated behind a profile, so a profile is required — there is no default/unprofiled bring-up:
Expected response:
For the API, dashboard, and docs together, use --profile dashboard-postgres-ghcr instead — see Dashboard.

​
In This Section

​
Choosing A Database

Decision Engine supports PostgreSQL and MySQL as interchangeable backends. Pick one and follow its dedicated guide, or go straight to Local Setup if you want the full profile matrix (dashboard, monitoring, source builds) rather than a database-first walkthrough.

​
Next Steps

  • API Guide — copy-paste curl examples once the service is running.