Download Self-Hosted CLI

Install cpctl, the Chainstack Self-Hosted command-line tool, on Linux, macOS, or Windows using the Chainstack bootstrap script for setup.

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

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

Windows

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

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

Windows

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

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

Windows

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

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

zsh

Load completions for the current session:

source <(cpctl completion zsh)

Load for every new session:

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

fish

Load completions for the current session:

cpctl completion fish | source

Load for every new session:

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

PowerShell

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:

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