> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lazycloud.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# compute, cloud, machine, domain

> Inspect compute, connect an AWS account, join your own machines, and register custom domains.

Workloads use LazyCloud compute by default. [Compute](/platform/compute)
covers setup and host requirements.

## lazycloud compute

```bash theme={null}
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.

```bash theme={null}
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

```bash theme={null}
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](/platform/compute#your-own-machines) list what the
machine needs.

## lazycloud domain

Custom domains are available on Team and Business plans.

```bash theme={null}
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](/platform/domains).

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