Skip to content

Command Line Tools

wheels deploy registry

Registry authentication on every host. setup and remove are aliases for login and logout respectively, kept for parity with Kamal.

VerbPurpose
setupAlias for login.
logindocker login on every host.
logoutdocker logout.
removeAlias for logout.

The registry.password: array in deploy.yml names secret keys. wheels deploy reads the first one via SecretResolver (which expands $(...) in .kamal/secrets) and sends it over the SSH session’s stdin to docker login --password-stdin, so it never appears in a command line. There is no --password flag: the deploy parser ignores it. registry login fails with DeployRegistryCli.MissingUsername when registry.username is empty and with DeployRegistryCli.MissingPassword when no password resolves (except under --dry-run).