# protect zone 3 min read * * * Copy Markdown for LLMs Manage the zones. ```bash protect zone ``` Commands: - [`attach`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#attach) Attach to the zone console. - [`list`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#list) List zone information. - [`launch`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#launch) Launch a new zone. - [`destroy`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#destroy) Destroy a zone. - [`exec`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#exec) Execute a command inside the zone. - [`logs`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#logs) View the logs of a zone. - [`metrics`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#metrics) Read metrics from the zone. - [`top`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#top) Dashboard for running zones. - [`watch`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#watch) Watch for zone changes. - [`update-resources`](https://docs.edera.dev/reference/cli/v0.0.1/zone/#update-resources) Update the available resources to a zone. ## attach [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#attach) ```bash protect zone attach ``` Arguments: - `` Zone to show logs for, either the name or the uuid. ## list [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#list) ```bash protect zone list [OPTIONS] [ZONE] ``` Arguments: - `[ZONE]` Limit to a single zone, either the name or the uuid. Options: - `-o, --output ` Output format \[default: table\] \[possible values: table, json, json-pretty, jsonl, yaml, key-value, simple\]. - `-l, --selector ` A selector for filtering the result set. Currently only supports ‘=’ and the ‘status.state’ field. Supported states include ‘creating’, ‘created’, ‘ready’, ’exited’, ‘destroying’, ‘destroyed’ and ‘failed’, with or without the ‘zone _state_’ prefix. (for example `--selector status.state=failed` or `--selector status.state=ZONE_STATE_FAILED`). ## launch [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#launch) ```bash protect zone launch [OPTIONS] ``` Options: - `--pull-overwrite-cache` Overwrite image cache on pull. - `--pull-update` Update image on pull. - `-n, --name ` Name of the zone. - `-C, --max-cpus ` Maximum vCPUs available for the zone \[default: 4\]. - `-c, --target-cpus ` Target vCPUs for the zone to use \[default: 1\]. - `-M, --max-memory ` Maximum memory available to the zone, in megabytes \[default: 1024\]. - `-m, --target-memory ` Target memory for the zone to use, in megabytes \[default: 1024\]. - `-D, --device ` Devices to request for the zone. - `-a, --attach` Attach to the zone after zone starts, implies –wait. - `-W, --wait` Wait for the zone to be ready, implied by –attach. - `-k, --kernel ` OCI kernel image for zone to use. - `-I, --initrd ` OCI initrd image for zone to use. - `-w, --working-directory `. Working directory. - `--kernel-verbose` Enable verbose logging on the kernel. - `--kernel-cmdline-append ` Additional kernel cmdline options. - `--assume-network-reservation ` Assume an already allocated network reservation. - `--retain-network-reservation` Retain network reservation after zone destruction. - `-R, --resource-adjustment-policy ` Resource adjustment policy \[possible values: static, dynamic\]. - `-V, --virt-backend ` Virtualization backend \[possible values: pv, pvh\]. ## destroy [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#destroy) ```bash protect zone destroy [OPTIONS] ``` Arguments: - `[ZONE]` Limit to a single zone, either the name or the uuid. Options: - `-W, --wait` Wait for the destruction of the zone to complete. - `-A, --all` Destroy all zones matching the input. - `-l, --selector ` A selector for filtering the result set. Currently only supports ‘=’ and the ‘status.state’ field. Supported states include ‘creating’, ‘created’, ‘ready’, ’exited’, ‘destroying’, ‘destroyed’ and ‘failed’, with or without the ‘zone _state_’ prefix. (for example `--selector status.state=failed` or `--selector status.state=ZONE_STATE_FAILED`). ## exec [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#exec) ```bash protect zone exec [OPTIONS] [COMMAND]... ``` Arguments: - `` Zone to exec inside, either the name or the uuid. - `[COMMAND]...` Command to run inside the zone. Options: - `-e, --env ` Environment variables. - `-w, --working-directory ` Working directory. - `-t, --tty` Allocate tty. ## logs [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#logs) ```bash protect zone logs [OPTIONS] ``` Arguments: - `` Zone to show logs for, either the name or the uuid. Options: - `-f, --follow` Follow output from the zone. ## metrics [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#metrics) ```bash protect zone metrics [OPTIONS] ``` Arguments: - `` Zone to show logs for, either the name or the uuid. Options: - `-o, --output ` Output format \[default: tree\] \[possible values: tree, json, json-pretty, yaml, key-value\]. ## top [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#top) ```bash protect zone top ``` ## watch [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#watch) ```bash protect zone watch [OPTIONS] ``` Options: - `-o, --output ` Output format \[default: simple\] \[possible values: simple, json, key-value\]. ## update-resources [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/zone/#update-resources) ```bash protect zone update-resources [OPTIONS] ``` Arguments: - `` Zone to update resources of, either the name or the uuid. - `-C, --max-cpus `. Maximum vCPUs available to the zone (0 means previous value) \[default: 0\]. - `-c, --target-cpus ` Target vCPUs for the zone to use (0 means previous value) \[default: 0\]. - `-M, --max-memory `. Maximum memory available to the zone, in megabytes (0 means previous value) \[default: 0\]. - `-m, --target-memory `. Target memory for the zone to use, in megabytes (0 means previous value) \[default: 0\]. - `-p, --adjustment-policy ` Adjustment policy \[possible values: static, dynamic\]. Last updated on 2026-07-07