compute, cloud, machine, domain

Workloads use LazyCloud compute by default. Compute covers setup and host requirements.

lazycloud compute

uv run lazycloud compute status       # capacity, connection, and workload count
uv run lazycloud compute instances    # running instances
uv run lazycloud compute workloads    # each workload and the machine it is pinned to

lazycloud cloud

Connecting an AWS account needs the Business plan. The connection belongs to your account and backs every workspace you own.

uv run lazycloud cloud connect aws --account-id <id> [--role-arn <arn>]
uv run lazycloud cloud authorize [--profile <aws-profile>]
uv run lazycloud cloud status [--watch] [--until <phase>] [--interval <s>] [--timeout <s>]
uv run lazycloud cloud validate            # recheck the current authorization
uv run lazycloud cloud reconnect  # start a replacement authorization
uv run lazycloud cloud cancel-reconnect
uv run lazycloud cloud retry               # retry the connection's pending action
uv run lazycloud cloud disconnect [--wait]

cloud authorize checks that your AWS CLI profile belongs to the connected account and submits the connection stack to CloudFormation, so your AWS credentials stay local. cloud validate confirms the result once the stack finishes, and cloud status --until ready waits for it.

lazycloud machine

uv run lazycloud machine list
uv run lazycloud machine join --name <name> --workspaces <a,b> [options]   # run on the machine you are joining
uv run lazycloud machine update <name-or-id> --workspaces <a,b>
uv run lazycloud machine remove MACHINE_ID

A joined machine has a name that is unique across your account and a list of workspaces whose workloads may run on it. A workload with machine="<name>" in its decorator runs on that machine or fails. machine join options:

Option	What it does
`--name <name>`	Machine name workloads pin to. Lowercase letters, digits, and hyphens. Required.
`--workspaces <a,b>`	Workspace names whose workloads may run here, comma-separated or repeated. Required.
`--gpu <model>`	GPU model this machine contributes.
`--max-cpu`, `--max-memory`, `--max-gpus`	Capacity to advertise, for example `--max-memory 32Gi`.
`--gpu-ids <ids>`	Comma-separated GPU device ids to expose, instead of `--max-gpus`.
`--background`, `--foreground`	Install the agent as a service, or run it in the terminal. Default is `--foreground`.
`--service-manager`, `--service-name`, `--state-dir`	Service installation details.

The host requirements list what the machine needs.

lazycloud domain

Custom domains are available on Team and Business plans.

uv run lazycloud domain add HOSTNAME       # prints the DNS records to create
uv run lazycloud domain status HOSTNAME
uv run lazycloud domain list
uv run lazycloud domain remove HOSTNAME

See Custom domains.

To change your default workspace, run uv run lazycloud workspace use <name>. Commands with a --workspace option can override it for one call.

Getting started

Core concepts

CLI reference

Examples

Account

compute, cloud, machine, domain

lazycloud compute

lazycloud cloud

lazycloud machine

lazycloud domain

​lazycloud compute

​lazycloud cloud

​lazycloud machine

​lazycloud domain

lazycloud compute

lazycloud cloud

lazycloud machine

lazycloud domain