Skip to content

Command Line Tools

wheels deploy setup

The first-time deploy verb. Runs the full wheels deploy flow and also boots kamal-proxy and every declared accessory. Use it once per environment; after that, plain wheels deploy is enough.

wheels deploy setup [--release=<v>] [--destination=<name>] [--dry-run]

Same as wheels deploy.

In Phase 2 the setup implementation reduces to the same flow as wheels deploy. The intent remains: on first run, the proxy container and any accessories boot as a side effect. On a fresh host, the first wheels deploy setup is slower than subsequent deploys because docker pull fetches every base image.

Expected preconditions:

  • Docker is installed on every host. Run wheels deploy bootstrap first if not (the flat alias — the nested wheels deploy server bootstrap form is picocli-shadowed).
  • Registry credentials resolve in .kamal/secrets.
  • ssh.user has passwordless sudo (or is root).
illustrative — requires Docker/Kamal environment
wheels deploy setup
wheels deploy setup --destination=staging