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

# Installation

> Install the standalone qumod CLI binary on macOS, Linux, or Windows.

# Installing `qumod`

`qumod` is the official command-line interface and automation runtime for Qumo Deploy. It is compiled as a self-contained, native executable with no external dependencies (neither Node.js nor Deno is required on the host system).

## Direct Binary Download (Recommended)

Pre-built standalone binaries are published with each release from the official repository:

| Platform    | Architecture             | Binary Asset              |
| :---------- | :----------------------- | :------------------------ |
| **macOS**   | Apple Silicon (M1/M2/M3) | `qumod-darwin-arm64`      |
| **macOS**   | Intel (x86\_64)          | `qumod-darwin-amd64`      |
| **Linux**   | x86\_64                  | `qumod-linux-amd64`       |
| **Linux**   | ARM64 (aarch64)          | `qumod-linux-arm64`       |
| **Windows** | x86\_64                  | `qumod-windows-amd64.exe` |

***

## macOS & Linux Quick Install

Run the following command to detect your operating system architecture, download the latest binary, verify permissions, and install to `/usr/local/bin`:

<CodeGroup>
  ```bash macOS (Apple Silicon) theme={null}
  curl -fsSL https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-darwin-arm64 -o /usr/local/bin/qumod
  chmod +x /usr/local/bin/qumod
  ```

  ```bash macOS (Intel) theme={null}
  curl -fsSL https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-darwin-amd64 -o /usr/local/bin/qumod
  chmod +x /usr/local/bin/qumod
  ```

  ```bash Linux (x86_64) theme={null}
  curl -fsSL https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-linux-amd64 -o /usr/local/bin/qumod
  chmod +x /usr/local/bin/qumod
  ```

  ```bash Linux (ARM64) theme={null}
  curl -fsSL https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-linux-arm64 -o /usr/local/bin/qumod
  chmod +x /usr/local/bin/qumod
  ```
</CodeGroup>

<Note>
  If `/usr/local/bin` is not in your `$PATH` or requires root privileges, you can install to `~/.local/bin/qumod` or run with `sudo`.
</Note>

***

## Windows Installation

On Windows, download the executable using PowerShell and add it to your user path:

```powershell PowerShell theme={null}
New-Item -ItemType Directory -Force -Path "$HOME\bin"
Invoke-WebRequest -Uri "https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-windows-amd64.exe" -OutFile "$HOME\bin\qumod.exe"
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$HOME\bin", "User")
```

Restart your terminal session or reload `$env:Path` to make `qumod` available globally.

***

## Verifying Installation

Verify that the CLI is installed properly and accessible:

```bash theme={null}
qumod version
```

Expected output:

```text theme={null}
qumod v0.1.0 (x86_64-apple-darwin)
API target: https://api.qumo.dev
```

You can also test JSON output format:

```bash theme={null}
qumod version --json
```

```json theme={null}
{
  "version": "0.1.0",
  "os": "darwin",
  "arch": "aarch64",
  "apiUrl": "https://api.qumo.dev"
}
```

***

## Next Steps

Now that you have `qumod` installed, authenticate your account:

<Card title="Authentication Guide" icon="key" href="/cli/authentication">
  Learn how to authenticate interactively via browser Device Flow or headless API tokens.
</Card>