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

# murmur pool up

> Start or restart the pool workflow so it begins maintaining warm VMs that let agents spawn in seconds instead of waiting for a fresh boot.

Ensures the [pool](/concepts/pools) workflow is running for your tenant. If the [pool](/concepts/pools) is already running, this is a no-op. If it has stopped or has not been started, this starts it.

Once running, the [pool](/concepts/pools) workflow continuously maintains warm VMs according to your [`pool-config`](/catalog/pool-config) limits and per-[workspace](/concepts/workspaces) `min_idle` settings.

## Synopsis

```bash theme={null}
murmur pool up [flags]
```

<Note>
  [Pool](/concepts/pools) commands run from your laptop only. They are not available on agent VMs.
</Note>

## Arguments

| Name          | Type   | Required | Description                                             |
| ------------- | ------ | -------- | ------------------------------------------------------- |
| `--workspace` | string | no       | Workspace name. Overrides the value from `murmur.yaml`. |

## Output

On success, prints a single confirmation line:

```
Pool workflow started
```

This message appears whether the workflow was already running or was newly started.

## Examples

### Start the pool

```bash theme={null}
murmur pool up
```

```
Pool workflow started
```

### Verify the pool is maintaining VMs

Run [`murmur pool status`](/cli/pool-status) after starting the [pool](/concepts/pools) to confirm warm VMs are being provisioned:

```bash theme={null}
murmur pool up && murmur pool status
```

```
Pool workflow started
warm: 2
  warm: murmur-a1b2c3d4 (murmur-a1b2c3d4)
  warm: murmur-e5f6g7h8 (murmur-e5f6g7h8)
```

## Errors

| Code                | Meaning                                                | What to do                                                         |
| ------------------- | ------------------------------------------------------ | ------------------------------------------------------------------ |
| `UNAUTHENTICATED`   | Identity token is missing or expired.                  | Run `murmur auth` or check your `murmur.local.yaml` configuration. |
| `PERMISSION_DENIED` | Your role does not have `pool-config.edit` permission. | Ask a tenant admin to grant you the required permission.           |
| (exit error)        | `pool commands are not supported on VMs`               | Run this command from your laptop, not from an agent VM.           |

## Related

* [Pools](/concepts/pools) — concept overview
* [`pool-config`](/catalog/pool-config) — catalog resource that controls pool capacity limits
* [`murmur pool status`](/cli/pool-status) — check the current pool state
* [`murmur pool flush`](/cli/pool-flush) — destroy warm VMs so the pool replenishes