Skip to main content

Usage

Flags

Description

Reads dokrypt.yaml, resolves dependencies, pulls required Docker images, creates networks, and starts all chains and services in the correct order. The startup process:
  1. Parse configuration — Reads dokrypt.yaml (with optional profile override)
  2. Initialize engine — Creates the container runtime and engine
  3. Create networks — Sets up Docker networks for service communication
  4. Start chains — Launches blockchain nodes (Anvil, Hardhat, or Geth)
  5. Fund accounts — Creates and funds test accounts with the configured balance
  6. Start services — Launches services in dependency order (parallel where possible)
  7. Health checks — Waits for all services to report healthy
  8. Save state — Persists container IDs and ports to ~/.dokrypt/state/
  9. Display status — Shows running services, URLs, and funded accounts

Examples

Start everything

Start in background

Start only the blockchain

Start with a fresh state

Destroys any existing containers and volumes before starting.

Fork mainnet on startup

Restore from snapshot on startup

Use a configuration profile

Profile overrides are defined in dokrypt.yaml under profiles:.

Custom timeout

Output

Errors