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

# launch

Launch a Komodo machine with whatever resources you need.

## Usage

`komo machine launch [OPTIONS] CONFIG_FILE`

## Options

| Option       | Required | Description                                                                                                                                                                                                            | Type |
| ------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- |
| ‑‑name       | No       | Job name. If not provided, a name will be generated.                                                                                                                                                                   | str  |
| ‑c, ‑‑cloud  | No       | Name of the cloud to use. If not provided, Komodo will select a cloud for you based on GPU prices and availability.                                                                                                    | str  |
| ‑g, ‑‑gpus   | No       | Which gpus to use, in the format \<GPU type>:\<Num GPUs> (eg. A100:4)                                                                                                                                                  | str  |
| ‑d, ‑‑detach | No       | Do not wait for the machine to start up.                                                                                                                                                                               | flag |
| ‑‑notebook   | No       | Launch a Jupyter Notebook on the machine.                                                                                                                                                                              | flag |
| ‑e, ‑‑env    | No       | Specify an environment variable in the form `--env key=value` or `--env key` (value will come from the value of `$key` in your shell). You can use this flag multiple times to specify multiple environment variables. | str  |

## Examples

Launch a machine named `dev`

```bash theme={null}
komo machine launch my-machine.yaml --name dev
```

Create a machine named `dev` on AWS with a single T4 GPU

```bash theme={null}
komo machine launch my-machine.yaml --cloud aws --gpus T4:1 dev
```

Create a machine named `dev`, but don't wait for it to start up.

```bash theme={null}
komo machine launch my-machine.yaml -d dev
```