---
title: "Local installation"
slug: "local-installation"
abstract: "Overview of the local installation of the Content Hub command line interface (CLI)."
---
# Local installation

You can install the Content Hub command line interface (CLI) locally.

> [!note]
> You must be an admin to install, update, or uninstall the CLI. When you uninstall the binaries, remove the extracted binary file and clean up the configuration in the user account directory.

> [!important]
> The `ch-cli` is built using .NET 8 and OS compatibility is determined by the .NET runtime. Verify that your operating system is [supported](https://github.com/dotnet/core/blob/main/release-notes/6.0/supported-os.md) before you start.

## Windows

[Chocolatey](https://chocolatey.org/) is a software management automation tool for Windows that wraps installers, executables, ZIP files, and scripts into compiled packages. Before you begin, ensure Chocolatey is installed.

### Install the CLI on Windows

To install the CLI on Windows, run the following command.

```shell
choco install sitecore.ch.cli --source https://nuget.sitecore.com/resources/v3/index.json

```

To verify the installation was successful, run the following command:

```shell
ch-cli --version

```

### Update the binary files

To update the binary files:

1. Download [the latest version](https://github.com/Sitecore/content-hub-cli).
2. Extract the archive.
3. On the command line, navigate to the location of the archive and run the following command:

    ```shell
    ch-cli
    ```

4. To verify that you now have the latest version, run the following command:

    ```shell
    ch-cli --version
    ```

### Update the CLI on Windows

To update the CLI on Windows, run the following command:

```shell
choco upgrade sitecore.ch.cli

```

### Uninstall the CLI on Windows

To uninstall the CLI on Windows, run the following command:

```shell
choco uninstall sitecore.ch.cli

```

## macOS or Linux

[Homebrew](https://brew.sh/) is a free and open-source software package management system that simplifies the installation of software. Before you begin, ensure Homebrew is installed.

> [!note]
> The minimum required OS version for macOS is version 10.13 High Sierra.

### Install the CLI on macOS or Linux

To install the CLI on macOS or Linux, run the following commands:

```shell
brew tap sitecore/content-hub
brew install ch-cli

```

To verify the installation was successful, run the following command:

```shell
ch-cli --version

```

### Update the binary files for macOS

To update the binary files for macOS:

1. Download [the latest version](https://github.com/Sitecore/content-hub-cli).
2. Extract the archive.
3. On the command line, navigate to the location of the archive and run the following command:

    ```shell
    ./ch-cli
    ```

### Update the binary files for Linux

Linux uses the following types of binaries:

- `linux-x64` - for most desktop distributions using [glibc](https://www.gnu.org/software/libc/).
- `linux-musl-x64` - for lightweight distributions (for example, Alpine Linux) using [musl](https://musl.libc.org/).

To update the binary files for Linux:

1. Download [the latest version](https://github.com/Sitecore/content-hub-cli).
2. Extract the archive.
3. On the command line, navigate to the location of the archive and run the following command:

    ```shell
    ./ch-cli
    ```

### Update the CLI on macOS or Linux

To update the CLI on macOS or Linux, run the following command:

```shell
brew update && brew upgrade

```

### Uninstall the CLI on macOS or Linux

To uninstall the CLI on macOS, run the following command:

```shell
brew uninstall ch-cli

```