> Documentation index: https://docs.kiste.run/llms.txt, a list of every page in this documentation.

# kiste new

> Start a new Kiste, then connect over SSH or open its desktop.

When NAME is a Kiste that already exists, `start` brings it back instead: a stopped one is resumed, a running one is attached to.

Aliases: `start`, `run`.

```text
kiste new [OPTIONS] [NAME]
```

| Argument | Description |
| --- | --- |
| `[NAME]` | Unique Kiste name. Omit to let the service generate one. |

| Option | Description |
| --- | --- |
| `--image IMAGE` | Universal machine image ID or slug. |
| `--profile PROFILE` | Machine profile. This release exposes one universal desktop-capable profile. Values: `desktop`. |
| `--desktop` | Start a graphical desktop Kiste and open it in the browser. |
| `--cpu CPU` | vCPUs (default universal shape: 4) |
| `--memory MEMORY` | Memory in MiB (default universal shape: 8192) |
| `--disk DISK` | Disk in MiB (default universal shape: 81920) |
| `--shape SHAPE` | Coherent resource preset: default (4/8/80), large (8/16/160) Values: `default`, `large`. |
| `--no-ssh` | Do not attach SSH after creation. |
| `--no-open` | With --desktop: print the desktop link instead of opening the browser. |
| `--environment NAME` | Immutable launch environment containing repositories and secrets. |
| `--ttl SECONDS` | Lifetime before the Kiste stops by itself (its disk stays): seconds, or 90m, 8h, 7d (at most 30d) |
| `--auto-snapshot SECONDS` | How often a changed disk is checkpointed (default 5m; checkpoints are always on): seconds, or 30m, 6h, 1d (at most 1d) |
| `--auth` | Carry the credentials selected with `kiste credentials` into the new Kiste. |

**Examples**

```text
kiste new                         Create with a generated name and attach SSH
kiste new review-42 --no-ssh      Create, select, and return to the shell
kiste new studio --desktop        Create and open the browser desktop
kiste new build --shape large     Use 8 vCPU, 16 GiB RAM, and 160 GiB disk
kiste new ci --ttl 3600 --json    Create unattended with a one-hour TTL
kiste start review-42             Bring review-42 back and attach SSH
```

Global options such as `--json` work with every command; see [the CLI overview](https://docs.kiste.run/cli.md#global-options).

## Related topics

- [Overview](https://docs.kiste.run/cli.md)
- [Output modes and exit codes](https://docs.kiste.run/cli/output.md)
- [Configuration and environment](https://docs.kiste.run/cli/configuration.md)
- [kiste login](https://docs.kiste.run/cli/login.md)
- [kiste logout](https://docs.kiste.run/cli/logout.md)
- [kiste whoami](https://docs.kiste.run/cli/whoami.md)
- [kiste account](https://docs.kiste.run/cli/account.md)
- [kiste credentials](https://docs.kiste.run/cli/credentials.md)
- [kiste ssh](https://docs.kiste.run/cli/ssh.md)
- [kiste ssh-config](https://docs.kiste.run/cli/ssh-config.md)
- [kiste exec](https://docs.kiste.run/cli/exec.md)
- [kiste prompt](https://docs.kiste.run/cli/prompt.md)
- [kiste cancel](https://docs.kiste.run/cli/cancel.md)
- [kiste interrupt](https://docs.kiste.run/cli/interrupt.md)
- [kiste command](https://docs.kiste.run/cli/command.md)
- [kiste commands](https://docs.kiste.run/cli/commands.md)
- [kiste desktop](https://docs.kiste.run/cli/desktop.md)
- [kiste list](https://docs.kiste.run/cli/list.md)
- [kiste status](https://docs.kiste.run/cli/status.md)
- [kiste current](https://docs.kiste.run/cli/current.md)
- [kiste watch](https://docs.kiste.run/cli/watch.md)
- [kiste events](https://docs.kiste.run/cli/events.md)
- [kiste stop](https://docs.kiste.run/cli/stop.md)
- [kiste restart](https://docs.kiste.run/cli/restart.md)
- [kiste rename](https://docs.kiste.run/cli/rename.md)
- [kiste update](https://docs.kiste.run/cli/update.md)
- [kiste resume](https://docs.kiste.run/cli/resume.md)
- [kiste extend](https://docs.kiste.run/cli/extend.md)
- [kiste fork](https://docs.kiste.run/cli/fork.md)
- [kiste scp](https://docs.kiste.run/cli/scp.md)
- [kiste forward](https://docs.kiste.run/cli/forward.md)
- [kiste delete](https://docs.kiste.run/cli/delete.md)
- [kiste logs](https://docs.kiste.run/cli/logs.md)
- [kiste image](https://docs.kiste.run/cli/image.md)
- [kiste snapshot](https://docs.kiste.run/cli/snapshot.md)
- [kiste environment](https://docs.kiste.run/cli/environment.md)
- [kiste stream](https://docs.kiste.run/cli/stream.md)
- [kiste auth](https://docs.kiste.run/cli/auth.md)
- [kiste devices](https://docs.kiste.run/cli/devices.md)
- [kiste config](https://docs.kiste.run/cli/config.md)
- [kiste completions](https://docs.kiste.run/cli/completions.md)
- [kiste self-update](https://docs.kiste.run/cli/self-update.md)
- [kiste limits](https://docs.kiste.run/cli/limits.md)
- [kiste doctor](https://docs.kiste.run/cli/doctor.md)
- Previous: [kiste account](https://docs.kiste.run/cli/account.md)
- Next: [kiste credentials](https://docs.kiste.run/cli/credentials.md)