# install
URL: https://synquic.tech/docs/cli/reference/install.md

Commands, arguments, and options for synq 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).

## synq install

Download and install the Synq desktop app (Mac or Windows) from synquic.tech

```text
synq install [options] [command]
```

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

| Option | Meaning |
| --- | --- |
| `--version <version>` | Version to install (e.g. 1.2.3; default: the latest) |
| `--latest` | Install the latest version (default) |
| `--force` | Re-download even if a verified copy is cached |
| `--no-launch` | Install without launching the app |

## synq install cache

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

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

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

## synq install cache clean

Delete cached release assets

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

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

## synq install cache list

List cached release assets

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

## synq install cache path

Print the cache directory path

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

## synq install cache verify

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

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

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