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

# Manage Compute Nodes

> List, deploy, inspect, control lifecycle, and delete compute nodes using np node commands.

Use `np node` (or `np nodes`) commands to manage compute node instances, inspect status, control power states, and access Guest VM MCP tools.

## List Nodes (`np node list`)

List all compute nodes in your organization.

```bash theme={null}
np node list
```

### Options

| Option     | Short | Description                       | Default |
| ---------- | ----- | --------------------------------- | ------- |
| `--format` | `-f`  | Output format (`table` or `json`) | `table` |

### Output Fields

* **VM UUID**: Unique virtual machine identifier.
* **Name**: Display name assigned to the node.
* **State**: Current state of the node (e.g. `running`, `stopped`).
* **SSH Connect**: Direct SSH command string for connecting to the node.

### Examples

<CodeGroup>
  ```bash Table Output theme={null}
  np node list
  ```

  ```bash JSON Output theme={null}
  np node list -f json
  ```
</CodeGroup>

***

## Create Node (`np node create`)

Deploy a new compute node instance.

```bash theme={null}
np node create [options]
```

### Options

| Option      | Short | Description                          | Default   |
| ----------- | ----- | ------------------------------------ | --------- |
| `--name`    | `-n`  | Display name for the compute node    | Generated |
| `--cpu`     | `-c`  | Number of vCPUs                      | `1`       |
| `--memory`  | `-m`  | Memory size in megabytes (MB)        | `512`     |
| `--network` |       | Network type (`private` or `public`) | `private` |
| `--storage` |       | Disk storage in gigabytes (GB)       | `10`      |

### Examples

<CodeGroup>
  ```bash Default Node theme={null}
  # Deploy 1 vCPU, 512 MB RAM private node
  np node create --name dev-node
  ```

  ```bash Custom Specs theme={null}
  # Deploy 2 vCPUs, 2048 MB RAM, 20 GB storage node
  np node create --name compute-worker --cpu 2 --memory 2048 --storage 20
  ```
</CodeGroup>

***

## Get Node Details (`np node get`)

Retrieve comprehensive details for a specific compute node.

```bash theme={null}
np node get <node_id> [options]
```

### Arguments

| Argument    | Description                                  |
| ----------- | -------------------------------------------- |
| `<node_id>` | Node ID, VM UUID, or display name (Required) |

### Options

| Option     | Short | Description                       | Default |
| ---------- | ----- | --------------------------------- | ------- |
| `--format` | `-f`  | Output format (`table` or `json`) | `table` |

### Detailed Fields

When using `table` output, `np node get` displays:

* **VM UUID**: Virtual machine UUID.
* **ID / Org ID / User ID**: Resource identifiers.
* **Name & Region**: Display name and deployment region.
* **State & Status**: Operational state and health status.
* **SSH Connect**: Prepared SSH connection string.
* **Hardware Specs**: Allocated CPU cores, Memory (MB), and Disk Storage (GB).

### Examples

<CodeGroup>
  ```bash Detailed Table theme={null}
  np node get node-12345
  ```

  ```bash Raw JSON theme={null}
  np node get dev-node -f json
  ```
</CodeGroup>

***

## Power Operations

Control node lifecycle power states with `boot`, `shutdown`, and `reboot`.

### Boot Node (`np node boot`)

Start a stopped compute node.

```bash theme={null}
np node boot <node_id>
```

### Shutdown Node (`np node shutdown`)

Gracefully shut down a running compute node.

```bash theme={null}
np node shutdown <node_id>
```

### Reboot Node (`np node reboot`)

Restart a compute node.

```bash theme={null}
np node reboot <node_id>
```

***

## Delete Node (`np node delete`)

Permanently delete a compute node and terminate its billing.

```bash theme={null}
np node delete <node_id>
```

<Warning>
  Deleting a node permanently destroys all data stored on its disk storage. This action cannot be undone.
</Warning>

***

## List Node Tools (`np node tools`)

List Model Context Protocol (MCP) tools exposed by the Guest VM running on a compute node.

```bash theme={null}
np node tools <node_id> [options]
```

### Options

| Option     | Short | Description                       | Default |
| ---------- | ----- | --------------------------------- | ------- |
| `--format` | `-f`  | Output format (`table` or `json`) | `table` |

### Examples

<CodeGroup>
  ```bash View Tools theme={null}
  np node tools node-12345
  ```

  ```bash JSON Tools Output theme={null}
  np node tools dev-node -f json
  ```
</CodeGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="SSH Keys" icon="key" href="/cli-reference/ssh">
    Register public SSH keys for automatic injection into new compute nodes.
  </Card>

  <Card title="CLI Overview" icon="sliders" href="/cli-reference/overview">
    Review CLI installation, global flags, and authentication configuration.
  </Card>
</CardGroup>