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

# Installs

> Deploy, manage, and interact with installs

**Alias:** `cnap inst`

## List installs

```bash theme={null}
cnap installs list
```

## Get install details

```bash theme={null}
cnap installs get <install-id>
```

## Create an install

```bash theme={null}
cnap installs create --product <product-id> --region <region-id>
```

Deploys a product to a region. Starts an async workflow.

| Flag        | Required | Description |
| ----------- | -------- | ----------- |
| `--product` | Yes      | Product ID  |
| `--region`  | Yes      | Region ID   |

## Delete an install

```bash theme={null}
cnap installs delete <install-id> --force
```

Triggers deletion of the deployment and its associated resources.

## Update helm values

```bash theme={null}
# Update template values for a helm source
cnap installs update-values <install-id> --source <helm-source-id> -f values.yaml

# Update per-install value overrides (applied on top of product base values)
cnap installs update-overrides <install-id> --source <helm-source-id> -f overrides.yaml
```

Both commands accept YAML or JSON files via the `-f` / `--values` flag.

| Flag           | Required | Description                        |
| -------------- | -------- | ---------------------------------- |
| `--source`     | Yes      | Helm source ID                     |
| `-f, --values` | Yes      | Path to values file (YAML or JSON) |

## List pods

```bash theme={null}
cnap installs pods <install-id>
```

## Stream logs

```bash theme={null}
# Interactive picker
cnap installs logs

# With explicit arguments
cnap installs logs <install-id> --pod <name> --container <name> --follow
```

When run without arguments, shows cascading pickers to select an install, pod, and container.

| Flag           | Description                           |
| -------------- | ------------------------------------- |
| `--pod`        | Pod name (all pods if omitted)        |
| `--container`  | Container name                        |
| `-f, --follow` | Follow log output (default: true)     |
| `--tail`       | Number of lines to tail               |
| `--since`      | Only return logs newer than N seconds |

## Interactive shell

```bash theme={null}
# Interactive picker
cnap installs exec

# With explicit arguments
cnap installs exec <install-id> --pod <name> --container <name> --shell /bin/bash
```

Opens a WebSocket connection to a pod container for interactive shell access.

| Flag          | Description                       |
| ------------- | --------------------------------- |
| `--pod`       | Pod name                          |
| `--container` | Container name                    |
| `--shell`     | Shell to use (default: `/bin/sh`) |