Skip to content

Command Line Tools

wheels deploy config

Print the fully-resolved deploy.yml config as YAML. Mustache interpolation is expanded; destination overlays are merged. Makes no network calls.

wheels deploy config [--destination=<name>] [--config=<path>]
FlagDescription
--destination=<name>Overlay deploy.<name>.yml before printing.
--config=<path>Override config/deploy.yml.

Prints a YAML dump with four keys that matter at deploy time:

example output
service: myapp
image: myorg/myapp
servers:
web:
- 192.0.2.10
registry:
server: ghcr.io
username: myorg

Full per-role options, env merging, and accessory blocks are not emitted in Phase 1 — wheels deploy config is a deliberate subset focused on what most users want to verify (which hosts, which image, which registry).

  • Verify --destination overlays apply the keys you expect.
  • Confirm {{env.*}} resolves to the right values.
  • Diff against kamal config during a migration from Ruby Kamal.
illustrative
wheels deploy config --destination=staging