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

# Quickstart

## Install

```bash theme={"theme":"css-variables"}
curl -LsSf https://machine0.io/install.sh | sh
```

Or via npm: `npm install -g @machine0/cli`

## Create a VM

```bash theme={"theme":"css-variables"}
machine0 new my-vm
```

Override defaults with `--image`, `--size`, `--region`. Change defaults permanently with `config set` ([configuration](/platform/configuration)).

## SSH in

```bash theme={"theme":"css-variables"}
machine0 ssh my-vm
```

The VM has a dedicated IP, HTTPS at `https://my-vm.mac0.io`, and root access via sudo. The CLI uses your `~/.ssh/id_rsa.pub` by default. See [SSH](/platform/ssh).

## Manage VMs

```bash theme={"theme":"css-variables"}
machine0 ls             # list VMs
machine0 get my-vm      # details
machine0 stop my-vm     # stop (still billed -- resources reserved)
machine0 suspend my-vm  # snapshot + destroy (pay only storage)
machine0 start my-vm    # start a stopped or suspended VM
machine0 rm my-vm       # destroy permanently
```

## Snapshot and clone

```bash theme={"theme":"css-variables"}
machine0 images new my-vm my-snapshot
machine0 rm my-vm
machine0 new my-clone --image my-snapshot --size xxl
```

See [Images](/platform/images).