Skip to main content

Usage

dokrypt config <subcommand> [flags]

Subcommands

SubcommandDescription
validateValidate dokrypt.yaml
showDisplay resolved configuration
initGenerate a default dokrypt.yaml

validate

Validate the dokrypt.yaml configuration file.
dokrypt config validate
Checks syntax, structure, and values. Reports:
  • Project name and version
  • Chains with their engine and chain ID
  • Services with their types and dependencies
  • Any validation errors

Example Output

Configuration valid!

Project: my-defi-app (v1.0)

Chains:
  ethereum  engine=anvil  chain_id=31337

Services:
  ipfs       type=ipfs
  explorer   type=blockscout  depends_on=[ethereum]
  oracle     type=chainlink-mock  depends_on=[ethereum]

Validation Rules

  • Runtime: Must be docker or podman
  • Log level: Must be debug, info, warn, or error
  • Engine: Must be anvil, hardhat, or geth
  • Hardfork: Must be london, shanghai, or cancun
  • Mining mode: Must be auto, interval, or manual
  • Service type: Must be a recognized type (see Services)

show

Display the fully resolved configuration as YAML.
dokrypt config show [flags]

Flags

FlagTypeDefaultDescription
--rawboolfalseShow raw file content without resolving defaults

Examples

# Show resolved config (with defaults applied)
dokrypt config show

# Show raw file as-is
dokrypt config show --raw

init

Generate a default dokrypt.yaml in the current directory.
dokrypt config init
Creates:
version: "1"
name: my-project

settings:
  runtime: docker
  log_level: info
  accounts: 10
  account_balance: "10000"

chains:
  ethereum:
    engine: anvil
    chain_id: 31337

services: {}

Errors

ErrorCauseSolution
dokrypt.yaml already existsConfig file existsDelete it first or edit manually