# install
URL: https://openship.io/docs/cli/reference/install.md

Commands, arguments, and options for openship install.

See the [CLI overview](/docs/cli) for examples. Global flags such as `--json` go before the command; see [global options](/docs/cli/reference#global-options).

## openship install

Download and install the Openship desktop app for this OS

```text
openship install [options] [command]
```

| Subcommand | Purpose |
| --- | --- |
| [`cache`](/docs/cli/reference/install#openship-install-cache) | Manage the local download cache (list/verify/clean/path) |

| Option | Meaning |
| --- | --- |
| `--version <tag>` | Release tag to install (e.g. v1.2.3) |
| `--latest` | Install the latest release (default) |
| `--force` | Re-download even if a verified copy is cached |
| `--no-verify` | Skip SHA-256 verification (allowed when no sidecar exists) |
| `--no-launch` | Install without launching the app |

## openship install cache

Manage the local download cache (list/verify/clean/path)

```text
openship install cache [options] [command]
```

| Subcommand | Purpose |
| --- | --- |
| [`path`](/docs/cli/reference/install#openship-install-cache-path) | Print the cache directory path |
| [`list\|ls`](/docs/cli/reference/install#openship-install-cache-list) | List cached release assets |
| [`verify [tag]`](/docs/cli/reference/install#openship-install-cache-verify) | Re-hash cached assets and compare to their .sha256 sidecar |
| [`clean [tag]`](/docs/cli/reference/install#openship-install-cache-clean) | Delete cached release assets |

## openship install cache clean

Delete cached release assets

```text
openship install cache clean [options] [tag]
```

| Argument | Meaning |
| --- | --- |
| `tag` | Only remove this release tag (default: all) |

## openship install cache list

List cached release assets

```text
openship install cache list|ls [options]
```

## openship install cache path

Print the cache directory path

```text
openship install cache path [options]
```

## openship install cache verify

Re-hash cached assets and compare to their .sha256 sidecar

```text
openship install cache verify [options] [tag]
```

| Argument | Meaning |
| --- | --- |
| `tag` | Only verify assets under this release tag |