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

# Install the Upsun CLI

> Install the Upsun CLI on macOS, Linux, or Windows to manage your projects from the terminal.

## Install

<CodeGroup>
  ```bash macOS (Homebrew) theme={null}
    brew install upsun/tap/upsun-cli
  ```

  ```bash Linux theme={null}
    curl -fsSL https://raw.githubusercontent.com/upsun/cli/main/installer.sh | bash
  ```

  ```bash Windows (Scoop) theme={null}
    scoop bucket add upsun https://github.com/upsun/homebrew-tap.git
    scoop install upsun
  ```
</CodeGroup>

<Info>
  If you are using Scoop, you **must** have the [Extras bucket](https://github.com/ScoopInstaller/Extras) already installed before installing the Upsun CLI.
</Info>

## Authenticate

To list and manage your projects, authenticate by running the following command:

```bash theme={null}
upsun
```

This process opens a browser tab for you to log in.
It also creates certificates on your computer for [SSH](/docs/development/ssh).

Once you are logged in, a list of your projects appears, along with some tips for getting started.
If you experience authentication issues or want to force a login, run the command `upsun login`.

For CI/CD pipelines and automation, use [API tokens](/cli/api-tokens) instead.

## Update the CLI

To update to the latest version, use the same tool as for [installation](#install):

<CodeGroup>
  ```bash Homebrew theme={null}
    brew upgrade upsun-cli
  ```

  ```bash Scoop theme={null}
    scoop update upsun
  ```
</CodeGroup>

## Upgrade from the legacy CLI

To upgrade from the legacy CLI, follow the [installation instructions above](#install).
Once you've installed the latest version, the CLI guides you through removing the installed legacy CLI.