Skip to main content
To install Chainstack Self-Hosted, run the installer for your operating system:
curl -sSL https://install.chainstack.com/cpctl.sh | sh
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 systemArchitectures
Linuxamd64 (x86_64), arm64 (aarch64)
macOSamd64 (x86_64), arm64 (aarch64)
Windowsamd64 (x86_64), arm64
32-bit systems (x86, ARM) are not supported.

Install a specific version

Pass the version as an argument:
curl -sSL https://install.chainstack.com/cpctl.sh | sh -s v1.4.6
Or set the CPCTL_VERSION environment variable:
CPCTL_VERSION=v1.4.6 curl -sSL https://install.chainstack.com/cpctl.sh | sh

Custom install directory

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
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.
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
Last modified on April 13, 2026