# nevia new

> Create a computer in the selected workspace

> Nevia is in beta and open to selected teams. Public launch in Dec 2026. The CLI installs with `curl -fsSL https://get.nevia.cloud | sh`, and the MCP server is at https://api.nevia.cloud/mcp. A person signs in once in the browser.
> Setup, sign-in and requesting access: [SKILL.md](https://nevia.cloud/SKILL.md). When Nevia fits and when it doesn't: [why.md](https://nevia.cloud/why.md).

> For the complete documentation index, see [llms.txt](https://nevia.cloud/llms.txt). This page's HTML version: https://nevia.cloud/docs/reference/cli/new

`nevia new [FLAGS] [NAME]`

### Arguments

* `[NAME]` - Name of the new computer (generated if omitted)

### Options

* `--image <REF>` - Image to run, one that `nevia images` lists (the platform default if omitted)
* `-p, --https-port <MAPPING>` - HTTPS port mapping PUBLISHED\[:TARGET]\[/h2], e.g. 443:3000/h2 (repeatable; published 443 or 8000-20000). See Computer ports and URLs in the reference
* `-e, --env <KEY=VALUE>` - Environment variable as KEY=VALUE, e.g. API\_KEY={{secrets.API\_KEY}} (repeatable). See Computer environment variables in the reference
* `--protected` - Refuse deletion until cleared with `nevia set --protected false`
* `--idempotency-key <KEY>` - Idempotency key for the request (generated if omitted)
* `--wait` - Wait for the operation to finish, then print the final state. With --json, prints `{<noun>, operation, operations}`
* `--timeout <DURATION>` - How long --wait waits before exiting 6 (e.g. 10m, 300s)

  **Default:** `10m`
* `-h, --help` - Print help