# Install the CLI

> Install the watasu CLI on macOS, Linux, WSL, or Windows.

The Watasu CLI is a single binary called `watasu`. It handles app management, deploys (via Git), config vars, add-ons, domains, and database operations.

## Install script (macOS, Linux, WSL)

```bash
curl -fsSL https://watasuio.github.io/watasu-cli/install.sh | bash
```

The script downloads the latest release, verifies its checksum, and installs the binary to `~/.local/bin` (or `~/bin`, whichever exists or is on your `PATH`). If the destination isn't on your `PATH`, the script tells you what to add.

To choose the destination yourself:

```bash
curl -fsSL https://watasuio.github.io/watasu-cli/install.sh | WATASU_INSTALL_DIR=/usr/local/bin bash
```

To pin a specific version instead of the latest:

```bash
curl -fsSL https://watasuio.github.io/watasu-cli/install.sh | bash -s -- v0.1.5
```

## PowerShell (Windows)

```powershell
irm https://watasuio.github.io/watasu-cli/install.ps1 | iex
```

Installs `watasu.exe` to `%LOCALAPPDATA%\Programs\Watasu\bin`. Set `WATASU_INSTALL_DIR` first to pick a different directory.

## Homebrew (macOS, Linux)

```bash
brew tap watasuio/watasu
brew install watasu
```

## Verify

```bash
watasu --version
watasu --help
```

You should see the version and the top-level command list.

## Update

* **Homebrew:** `brew upgrade watasu`
* **Install script:** re-run the install command — it always fetches the latest release.

## Next

* **[Authenticate](https://docs.watasu.io/cli/authentication.md)** — log in so the CLI can talk to the platform
* **[Quickstart](https://docs.watasu.io/getting-started/quickstart.md)** — deploy your first app
* **[Command Reference](https://docs.watasu.io/cli/reference.md)** — every command, in one place

[View this page on the web](https://docs.watasu.io/cli/install/)