Lux Docs

Docker

Building and running Docker images

Backend Image

cd explorer
docker build -t ghcr.io/luxfi/blockscout-lux:latest \
  --build-arg MIX_ENV=prod \
  -f docker/Dockerfile .

Multi-stage build: Elixir compilation → OTP release → Alpine runtime.

Frontend Image

cd explore
docker build -t ghcr.io/luxfi/explore:latest \
  --build-arg GIT_COMMIT_SHA=$(git rev-parse HEAD) \
  -f Dockerfile .

Three-stage build: deps → builder → runner (Node.js Alpine).

Docker Compose

cd explore
docker compose up -d

Services:

  • redis — Cache (redis:alpine)
  • postgres — Database (ghcr.io/hanzoai/sql)
  • backend — Blockscout (port 4000)
  • frontend — Next.js (port 3000)

Production Compose

docker compose -f compose.prod.yml up -d

Uses pre-built images from GHCR and production environment variables.

On this page