XRAY/Graph Kupmios — Dockerized Kupo & Ogmios (Cardano Node) stack

XRAY/Graph Kupmios is a tool for fast and predictable deployment of Haproxy (TCP/HTTP Load Balancer), Ogmios (Cardano Node), and Kupo (customizable Cardano blockchain indexer) stack in a docker environment. Used in the XRAY/Graph distributed Cardano API provider.

Getting Started

Prepare Installation

git clone \
  --recurse-submodules \
  https://github.com/xray-network/xray-graph-kupmios.git \
  && cd xray-graph-kupmios

cp .env.example .env

Build and Run via Docker Compose

You can combine profiles to run multiple networks on the same machine: docker compose --profile mainnet --profile preprod --profile preview up -d

MAINNET

Default

docker compose --profile mainnet up -d

Advanced usage (Kupo config)

KUPO_MATCH_MAINNET=* \
KUPO_SINCE_MAINNET=origin \
docker compose --profile mainnet up -d

PREPROD

Default

docker compose --profile preprod up -d

Advanced usage (Kupo config)

KUPO_MATCH_PREPROD=* \
KUPO_SINCE_PREPROD=origin \
docker compose --profile preprod up -d

PREVIEW

Default

docker compose --profile preview up -d

Advanced usage (Kupo config)

KUPO_MATCH_PREVIEW=* \
KUPO_SINCE_PREVIEW=origin \
docker compose --profile preview up -d

Documentation

• Kupo — https://cardanosolutions.github.io/kupo/
• Ogmios — https://ogmios.dev/
• Haproxy — https://www.haproxy.org/