# Installation

## Installing the ZCP CLI

The ZCP CLI (`zcp`) is the official command-line interface for ZSoftly Public Cloud. It lets you manage VMs, networks, storage, Kubernetes, and more from your terminal.

Current version: [![Latest zcp CLI release](https://img.shields.io/github/v/release/zsoftly/zcp-cli?style=flat&label=&color=3b82f6)](https://github.com/zsoftly/zcp-cli/releases/latest)
 GitHub: [https://github.com/zsoftly/zcp-cli](https://github.com/zsoftly/zcp-cli)
 Releases: [https://github.com/zsoftly/zcp-cli/releases](https://github.com/zsoftly/zcp-cli/releases)

v0.0.14 breaking change for Go module consumers. All API service packages and the HTTP client moved from `internal/` to `pkg/` so external modules (including the ZCP Terraform provider) can import them. CLI end users are not affected. Update import paths:

| Old path | New path |
| --- | --- |
| `github.com/zsoftly/zcp-cli/internal/api/<service>` | `github.com/zsoftly/zcp-cli/pkg/api/<service>` |
| `github.com/zsoftly/zcp-cli/internal/httpclient` | `github.com/zsoftly/zcp-cli/pkg/httpclient` |

### Linux and macOS

```bash
curl -fsSL https://github.com/zsoftly/zcp-cli/releases/latest/download/install.sh | bash
```

After installation, verify:

```bash
zcp version
```

### Windows (PowerShell)

```powershell
irm https://github.com/zsoftly/zcp-cli/releases/latest/download/install.ps1 | iex
```

The current release is v1.1.0. See the [GitHub releases page](https://github.com/zsoftly/zcp-cli/releases). The release installer upgrades an existing installation in place.

### Manual download

Download the binary for your platform from the [GitHub releases page](https://github.com/zsoftly/zcp-cli/releases):

| Platform | Architecture | Binary |
| --- | --- | --- |
| Linux | amd64 | `zcp-linux-amd64` |
| Linux | arm64 | `zcp-linux-arm64` |
| macOS | amd64 | `zcp-darwin-amd64` |
| macOS | arm64 (Apple Silicon) | `zcp-darwin-arm64` |
| Windows | amd64 | `zcp-windows-amd64.exe` |

Make the binary executable (Linux/macOS):

```bash
chmod +x zcp-linux-amd64
sudo mv zcp-linux-amd64 /usr/local/bin/zcp
```

### Build from source

Requires Go 1.26.0 or later. The selected toolchain is Go 1.26.9:

```bash
git clone https://github.com/zsoftly/zcp-cli
cd zcp-cli
make build
sudo mv bin/zcp /usr/local/bin/zcp
```

### Shell completions

```bash
# Bash
zcp completion bash > /etc/bash_completion.d/zcp


# Zsh
zcp completion zsh > "${fpath[1]}/_zcp"


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


# PowerShell
zcp completion powershell >> $PROFILE
```

See also: [Quickstart](https://docs.zcp.zsoftly.ca/public-cloud/cli/quickstart), [Configuration](https://docs.zcp.zsoftly.ca/public-cloud/cli/configuration)