Skip to main content
The lazycloud command installs with the lazycloud-client Python package. See Installation. Sign in once with lazycloud login, as described in Sign-in and tokens.
--json prints one JSON document to stdout for scripting. Progress goes to stderr. An error prints one JSON error document and exits nonzero. Log-follow commands print newline-delimited JSON, one record per event. The interactive commands shell, dev, and serve reject --json. --debug shows full tracebacks. -h or --help works on every command. Without --json, output is for humans. The CLI drops styling when you redirect output. Develop, test, deploy explains when run, serve, and deploy each fit.

​
Handler references

Commands that take a HANDLER use module:object, resolved from your project root:
  • quickstart:hello selects hello in quickstart.py.
  • myproject.api:app selects app in myproject/api.py.
Dots separate directory names, and .py is omitted. A file reference such as quickstart.py:hello also works and resolves to the same handler. The object is one decorated resource or an App. Deploying an App deploys everything it registers. Referencing one workload’s Python object, for example page_stats:analyze, deploys only that workload. deploy also accepts a module without :object, such as uv run lazycloud deploy quickstart, when the module contains exactly one app. It deploys everything registered with that app. When the module has several apps, module:app_name selects one.

​
Command groups