Skip to main content

​
What is Dokrypt?

Dokrypt is Docker for Web3 — a CLI tool that gives you a complete local development environment for building decentralized applications. It manages local blockchain nodes, IPFS, block explorers, oracles, indexers, and more, all from a single dokrypt.yaml configuration file. Think of it as docker-compose but purpose-built for Web3. One command spins up everything you need.

​
Why Dokrypt?

Building dApps requires juggling multiple tools: a local chain (Anvil, Hardhat, Geth), IPFS for storage, a block explorer for debugging, an oracle for price feeds, an indexer for querying data. Setting this up manually is tedious and error-prone. Dokrypt handles all of this:
  • One config file — Define your entire stack in dokrypt.yaml
  • One command — dokrypt up starts everything
  • Built-in templates — Scaffold complete projects (DeFi, NFT, DAO, Token) in seconds
  • State snapshots — Save, restore, diff, export, and import chain state
  • Chain forking — Fork mainnet or any EVM chain at any block
  • Testing framework — Run Solidity and JS/TS tests with gas reports and coverage
  • Chain utilities — Time-travel, set balances, mine blocks, impersonate accounts
  • Cross-chain bridge — Simulate multi-chain transfers locally

​
Quick Example

# Install
npm install -g dokrypt

# Create a new DeFi project
dokrypt init my-defi-app --template evm-defi

# Start everything
cd my-defi-app
dokrypt up

# Your environment is running:
# ✓ ethereum    Ready  ▸ http://localhost:8545
# ✓ ipfs        Ready  ▸ http://localhost:5001
# ✓ blockscout  Ready  ▸ http://localhost:4000
# ✓ oracle      Ready  ▸ chainlink-mock

​
Architecture

Dokrypt runs on top of Docker (or Podman). Each chain and service runs as a container, connected via Docker networks. The CLI orchestrates container lifecycle, health checks, dependency ordering, and networking.

​
Supported Chains

Dokrypt supports all EVM-compatible chains for local development and forking:
ChainFork SupportChain ID (mainnet)
EthereumYes1
PolygonYes137
ArbitrumYes42161
OptimismYes10
BaseYes8453
BSCYes56
AvalancheYes43114
SepoliaYes11155111

​
Supported Services

ServiceTypeDescription
IPFSipfsDecentralized file storage
BlockscoutblockscoutBlock explorer
OtterscanotterscanLightweight block explorer
The GraphsubgraphIndexing protocol
PonderponderIndexing framework
Chainlink Mockchainlink-mockOracle price feeds
Pyth Mockpyth-mockPyth oracle mock
GrafanagrafanaMonitoring dashboards
PrometheusprometheusMetrics collection
FaucetfaucetTest token faucet
Mock Bridgemock-bridgeCross-chain bridge simulator
CustomcustomAny Docker image

​
Next Steps

Installation

Install Dokrypt via npm, Docker, or binary download.

Quickstart

Build your first dApp in under 5 minutes.

Templates

Explore the 5 built-in project templates.

CLI Reference

Full reference for all 58 CLI commands.