---
title: update
description: Update the running CLI through its install owner.
canonical_url: https://orchestor.io/docs/en/cli/update
markdown_url: https://orchestor.io/docs/en/cli/update.md
contentType: reference
---

# update

`orc update` detects the install owner of the running CLI and delegates to that owner’s update command. It does not overwrite a distribution managed by another owner. `--check` reports the owner, current version, latest version, and planned command without updating.

## Usage

```bash title="terminal"
orc update --check
```

*Inspect the update plan.*

## Behavior by install owner

| Install owner | Behavior |
| --- | --- |
| `native` | Runs `curl -fsSL https://orchestor.io/install \| ORCHESTOR_NON_INTERACTIVE=1 bash`. |
| `brew` | Runs `brew upgrade --cask orchestor`. |
| `winget` | Prints `winget upgrade Dotmedia.Orchestor` without running it. |
| `npm` | Runs `npm install -g @orchestor-inc/cli@latest`. |
| `unknown` | Does not update and returns exit code 1. |

## Unique options

### `--check`

Show the install owner, latest version, and update command without updating

Type: `boolean`. Optional.

```bash title="terminal"
orc update --check
```

## Examples

### Update through the detected install owner.

```bash title="terminal"
orc update
```

*Update through the detected install owner.*

## Update notifications

After an interactive command succeeds, the CLI checks for a new version at most once every 20 hours. If a newer version exists, it prints the owner-specific update command to standard error. Notifications are skipped for machine-readable output, `orc update --check`, and development builds.

`ORCHESTOR_NO_UPDATE_CHECK=1` disables checks and notifications, but does not disable manual `orc update`.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc update`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)