kiste new – Kiste Docs

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.

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

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.