# Install Shoplazza CLI

> Install Shoplazza CLI on macOS, Windows, or Linux via npm, the shell script, or a GitHub release binary, then verify the version and enable shell completion.

This guide shows you how to install [Shoplazza CLI](/docs/app/developer-tools/shoplazza-cli/) on macOS, Windows, or Linux.

## Requirements

| Requirement | Version |
|-------------|---------|
| [Node.js](https://nodejs.org/en/download) | 18.0.0 or higher |
| [Git](https://git-scm.com/downloads) | Latest recommended |

:::tip
Node.js is required for extension development toolchains (checkout extensions, theme extensions). If you only use the CLI for API commands and shortcuts, the standalone binary works without Node.js.
:::

## Install via npm (recommended)

```shell
npm install -g shoplazza-cli
```

## Install via shell script (macOS / Linux)

For environments without Node.js, you can install the standalone Go binary:

```shell
curl -fsSL https://raw.githubusercontent.com/shoplazza/shoplazza-cli/main/install.sh | bash
```

The script automatically detects your OS and architecture, downloads the appropriate binary, and places it in `/usr/local/bin`.

To install a specific version:

```shell
curl -fsSL https://raw.githubusercontent.com/shoplazza/shoplazza-cli/main/install.sh | bash -s -- --version v2.0.0
```

## Install from GitHub Releases

Download the pre-built binary for your platform from the [GitHub Releases](https://github.com/shoplazza/shoplazza-cli/releases) page.

| Platform | Architecture | File |
|----------|-------------|------|
| macOS | Intel (x86_64) | `shoplazza-cli_darwin_amd64.tar.gz` |
| macOS | Apple Silicon (arm64) | `shoplazza-cli_darwin_arm64.tar.gz` |
| Linux | x86_64 | `shoplazza-cli_linux_amd64.tar.gz` |
| Linux | arm64 | `shoplazza-cli_linux_arm64.tar.gz` |
| Windows | x86_64 | `shoplazza-cli_windows_amd64.zip` |

After downloading, extract the binary and move it to a directory in your `PATH`:

```shell
tar -xzf shoplazza-cli_darwin_arm64.tar.gz
sudo mv shoplazza /usr/local/bin/
```

## Verify the installation

```shell
shoplazza version
```

The command returns the version number, build date, and Go version.

## Shell completion

Shoplazza CLI supports shell completion for bash, zsh, fish, and PowerShell:

```shell
# Bash
shoplazza completion bash > /etc/bash_completion.d/shoplazza

# Zsh
shoplazza completion zsh > "${fpath[1]}/_shoplazza"

# Fish
shoplazza completion fish > ~/.config/fish/completions/shoplazza.fish

# PowerShell
shoplazza completion powershell > shoplazza.ps1
```

## Upgrade

```shell
# npm
npm update -g shoplazza-cli

# shell script (re-run installer)
curl -fsSL https://raw.githubusercontent.com/shoplazza/shoplazza-cli/main/install.sh | bash
```

## Next steps

* [Quick start](./quickstart) — Install, authenticate, and run your first command
* [Authentication](./authentication) — Set up OAuth 2.0 credentials
* [Command reference](./commands/) — Explore all available commands