Mashharuki Midnight Sample Fullstack App Midnight Infra Setup

Midnight Infrastructure Setup (Docker Compose)

All infrastructure runs via Docker Compose — no Rust/Cargo compilation required.

Two Modes

Mode A: Proof Server Only (Preprod / Preview)

Use this when you want to connect to a public testnet but need a local proof server.

cd counter-cli
docker compose -f proof-server.yml up

proof-server.yml:

services:
  proof-server:
    image: 'midnightntwrk/proof-server:8.0.3'
    command: ['midnight-proof-server -v']
    ports:
      - '6300:6300'
    environment:
      RUST_BACKTRACE: 'full'

Verify it's running:

curl http://localhost:6300/version
# Returns the proof server version

Mode B: Standalone (Full Local Stack)

Starts all three services needed for local development. The CLI handles this automatically:

cd counter-cli
npm run standalone

Or start manually:

cd counter-cli
docker compose -f standalone.yml up

standalone.yml (abridged):

services:
  proof-server:
    image: 'midnightntwrk/proof-server:8.0.3'
    ports: ['6300']

  indexer:
    image: 'midnightntwrk/indexer-standalone:4.0.0'
    ports: ['0:8088']
    environment:
      APP__APPLICATION__NETWORK_ID: 'undeployed'
    depends_on:
      node:
        condition: service_healthy

  node:
    image: 'midnightntwrk/midnight-node:0.22.3'
    ports: ['9944']
    environment:
      CFG_PRESET: 'dev'

Service Endpoints

NetworkId for standalone: 'undeployed'

Health Checks

# Proof server
curl http://localhost:6300/version

# Indexer GraphQL (standalone)
curl http://127.0.0.1:8088/api/v3/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"{ __typename }"}'

# Node (standalone)
curl http://127.0.0.1:9944/health

Startup Sequence (Standalone)

The services must start in order. Docker Compose handles this with depends_on + health checks:

1. midnight-node:0.22.3  starts first
   └─ healthcheck: GET /health every 2s, up to 20 retries
2. indexer-standalone:4.0.0  starts after node is healthy
   └─ healthcheck: cat /var/run/indexer-standalone/running
3. proof-server:8.0.3  starts independently
   └─ healthcheck: GET /version every 10s

Allow ~30-60 seconds for all services to initialize on first run.

Using preprod-ps / preview-ps Scripts

The npm scripts handle Docker + CLI together:

# Pull latest images and start proof server + CLI
npm run preprod-ps   # Preprod + auto-start proof server
npm run preview-ps   # Preview + auto-start proof server

These scripts:

1. docker compose -f proof-server.yml pull (update images)
2. Start CLI with ts-node

Troubleshooting

Stop Services

# Stop all (keep containers)
docker compose -f proof-server.yml stop

# Stop and remove containers
docker compose -f proof-server.yml down

# Stop standalone
docker compose -f standalone.yml down

Docker Image Versions (current)

These versions are locked in counter-cli/standalone.yml and counter-cli/proof-server.yml. Use the exact versions specified there to ensure compatibility.

References

• Docker Documentation
• example-counter standalone.yml
• Midnight Docs

Source: mashharuki/midnight-sample-fullstack-app — distributed by TomeVault.