Skip to main content

CLI Installation

warning

tl;dr IFF you know what you're doing.

brew tap pokt-network/poktroll
brew install poktrolld

MacOS & Linux Users​

Using Homebrew​

Ensure you have Homebrew installed.

Then run the following commands:

brew tap pokt-network/poktroll
brew install poktrolld

And verify it worked by running:

poktrolld version
poktrolld --help
tip

See the homebrew-poktroll repository for details on how to install homebrew or other details to install or debug the CLI.

From Source​

Installing dependencies​

Ensure you have the following installed:

If you're on a Linux machine, you can follow the steps below for convenience:

# Install go 1.23
curl -o ./pkgx --compressed -f --proto '=https' https://pkgx.sh/$(uname)/$(uname -m)
sudo install -m 755 pkgx /usr/local/bin
pkgx install go@1.23.0
export PATH=$PATH:$HOME/go/bin/

# Install PATH Gateway required dependencies
apt-get update && apt-get install git make build-essential

# Install the ignite binary used to build the Pocket binary
curl https://get.ignite.com/cli! | bash

Installing poktrolld​

Then, Retrieve the source code and build the poktrolld locally like so:

git clone https://github.com/pokt-network/poktroll.git
cd poktroll
make go_develop
make ignite_poktrolld_build

And verify it worked by running:

poktrolld version
poktrolld --help

Using release binaries​

Pre-built binaries are available on our releases page.

The following snippet downloads/upgrades the binary to the latest released version:

# Download the correct binary based on the OS and architecture
curl -LO "https://github.com/pokt-network/poktroll/releases/latest/download/poktroll_$(uname | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz"

# Extract the downloaded tarball to /usr/local/bin
sudo tar -zxf "poktroll_$(uname | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" -C /usr/local/bin

# Make the binary executable
sudo chmod +x /usr/local/bin/poktrolld

# Check version
poktrolld version

Windows Users​

Currently, we do not support native Windows installation. Windows users are encouraged to use Windows Subsystem for Linux (WSL) and follow the Linux installation instructions.