Download Self-Hosted CLI

cpctl is the command-line tool for installing and upgrading Chainstack Self-Hosted. This page covers getting it onto your local machine.

Installing cpctl only puts it on your machine. It does not deploy the Control Panel itself — for that, see Installation.

To install cpctl, run the script for your operating system:

Linux / macOS
Windows

curl -sSL https://install.chainstack.com/cpctl.sh | sh

irm https://install.chainstack.com/cpctl.ps1 | iex

This downloads and runs the cpctl installer script, which sets up the Chainstack Self-Hosted command-line tool on your system.

Supported platforms

The installer automatically detects your operating system and architecture.

Operating system	Architectures
Linux	amd64 (x86_64), arm64 (aarch64)
macOS	amd64 (x86_64), arm64 (aarch64)
Windows	amd64 (x86_64), arm64

32-bit systems (x86, ARM) are not supported.

Install a specific version

Linux / macOS
Windows

Pass the version as an argument:

curl -sSL https://install.chainstack.com/cpctl.sh | sh -s v1.8.0

Or set the CPCTL_VERSION environment variable:

CPCTL_VERSION=v1.8.0 curl -sSL https://install.chainstack.com/cpctl.sh | sh

iwr https://install.chainstack.com/cpctl.ps1 -OutFile cpctl.ps1
.\cpctl.ps1 -Version v1.8.0

Or set the CPCTL_VERSION environment variable:

$env:CPCTL_VERSION = "v1.8.0"
irm https://install.chainstack.com/cpctl.ps1 | iex

Custom install directory

Linux / macOS
Windows

By default, cpctl installs to /usr/local/bin/. To override the install directory, set the CPCTL_INSTALL_DIR environment variable:

CPCTL_INSTALL_DIR=/opt/bin curl -sSL https://install.chainstack.com/cpctl.sh | sh

By default, cpctl installs to %LOCALAPPDATA%\cpctl\ and is automatically added to the user PATH.

Make sure your server meets the system requirements before running the installer.

Verify the cpctl binary

After the installer completes, confirm that cpctl is available and check its version:

cpctl version

Shell completion

cpctl can generate shell completion scripts for bash, zsh, fish, and PowerShell.

bash
zsh
fish
PowerShell

Load completions for the current session:

source <(cpctl completion bash)

Load for every new session:

# Linux
cpctl completion bash > /etc/bash_completion.d/cpctl

# macOS
cpctl completion bash > $(brew --prefix)/etc/bash_completion.d/cpctl

Load completions for the current session:

source <(cpctl completion zsh)

Load for every new session:

cpctl completion zsh > "${fpath[1]}/_cpctl"

Load completions for the current session:

cpctl completion fish | source

Load for every new session:

cpctl completion fish > ~/.config/fish/completions/cpctl.fish

Load completions for the current session:

cpctl completion powershell | Out-String | Invoke-Expression

To persist, add that line to your PowerShell profile ($PROFILE).

Next steps

With cpctl on your machine, you’re ready to set up the cluster and deploy the Control Panel:

Environment setup — Set up your Kubernetes cluster and required tools, if not already done
Installation — Deploy the Control Panel using cpctl install
Quick start — End-to-end walkthrough from a fresh server

Self-Hosted

Installation

Node management

Help

Download Self-Hosted CLI

Supported platforms

Install a specific version

Custom install directory

Verify the cpctl binary

Shell completion

Next steps

​Supported platforms

​Install a specific version

​Custom install directory

​Verify the cpctl binary

​Shell completion

​Next steps

Supported platforms

Install a specific version

Custom install directory

Verify the cpctl binary

Shell completion

Next steps