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

# upgrade

> cpln upgrade — Update the cpln CLI to the latest version in place.

Upgrade the cpln CLI to the latest version

**Usage**

```none theme={null}
cpln upgrade [OPTIONS]
```

<Note>
  `cpln update` is an alias for `cpln upgrade`.
</Note>

<Accordion title="Reference">
  ```text theme={null}
  Upgrade options:
    --check, -c  Report the installed and latest versions without upgrading  [boolean]
    --force      Upgrade even when already on the latest version  [boolean]

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help         Show help  [boolean]
    --version, -v  Show version number  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  * Check for a newer version without upgrading

  <CodeGroup>
    ```bash Command theme={null}
    cpln upgrade --check
    ```

    ```text Output theme={null}
    Installed version: 3.13.0
    Latest version:    3.14.0
    Install method:    npm
    A newer version is available: 3.14.0. Run 'cpln upgrade' to install it.
    ```
  </CodeGroup>

  * Upgrade in place

  <CodeGroup>
    ```bash Command theme={null}
    cpln upgrade
    ```

    ```text Output theme={null}
    ✓ cpln upgrade completed.
    ```
  </CodeGroup>
</Accordion>

***