Lux Docs

Deployment

Docker and Kubernetes deployment

The Lux Indexer runs as Docker containers on Kubernetes, managed by the Lux Operator. It indexes all Lux chain types -- linear chains (P, C), DAG chains (X, A, B, Q, T, Z, K), and EVM chains (C, Zoo, Hanzo, SPC, Pars).

Docker Image

# Build the indexer binary
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -tags postgres ./cmd/indexer

# Image
ghcr.io/luxfi/indexer:v0.2.2

Kubernetes Architecture

13 indexer pods (lux-explorer namespace)
  indexer-cchain:4000    C-Chain EVM
  indexer-pchain:4100    P-Chain linear
  indexer-xchain:4200    X-Chain DAG
  indexer-qchain:4300    Q-Chain DAG
  indexer-zchain:4400    Z-Chain DAG
  indexer-achain:4500    A-Chain DAG
  indexer-bchain:4600    B-Chain DAG
  indexer-tchain:4700    T-Chain DAG
  indexer-kchain:4900    K-Chain DAG

PostgreSQL

All indexer instances share a single PostgreSQL instance:

indexer-postgres-0 (20Gi PVC)
  Database: indexer
  User: indexer
  Port: 5432

External API Endpoints

ChainExternal URL
C-Chainapi-indexer.lux.network
P-Chainapi-indexer-pchain.lux.network
X-Chainapi-indexer-xchain.lux.network
Q-Chainapi-indexer-qchain.lux.network
Z-Chainapi-indexer-zchain.lux.network

Environment Variables

VariableDescription
DATABASE_URLPostgreSQL connection string
LUX_RPC_URLluxd RPC endpoint
LUX_CHAIN_IDChain ID for validation
INDEXER_CHAINChain type (evm, pchain, xchain, etc.)
INDEXER_PORTHTTP listen port

Build Tags

# Default (SQLite)
go build ./cmd/indexer

# PostgreSQL (production)
go build -tags postgres ./cmd/indexer

On this page