Skip to content

Command Line Tools

wheels deploy registry login

docker login to the configured registry on every host.

wheels deploy registry login [--password=<value>] [--destination=<name>] [--dry-run]
FlagDescription
--password=<value>Pass the password literally. Overrides the resolved registry.password[0] secret.
--destination=<name>Overlay destination config.
--dry-runPrint the commands without executing.

Per host:

echo <password> | docker login <server> --username <username> --password-stdin

Password comes from .kamal/secrets via the first key in registry.password:, or from --password when provided.

wheels deploy runs this automatically before a push. Call it directly if you want to pre-authenticate hosts outside the deploy flow.

example (illustrative — requires deployment infrastructure)
wheels deploy registry login