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:
GitHub: 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

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

After installation, verify:

zcp version

Windows (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. The release installer upgrades an existing installation in place.

Manual download

Download the binary for your platform from the GitHub releases page:

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):

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:

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

Shell completions

# 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