Skip to main content

pocketd CLI Installation

TL;DR

To install pocketd on Linux or MacOS, run:

curl -sSL https://raw.githubusercontent.com/pokt-network/poktroll/main/scripts/install.sh | bash

Table of Contents


1. Install Script (Linux & MacOS)

Easiest, fastest way to get started that works on both Linux and MacOS.

curl -sSL https://raw.githubusercontent.com/pokt-network/poktroll/main/scripts/install.sh | bash

Verify installation:

pocketd version
pocketd --help

2. Homebrew (MacOS only)

For MacOS users who prefer Homebrew.

brew tap pokt-network/poktroll
brew install pocketd

Troubleshooting Homebrew

If you have problems installing or upgrading pocketd via Homebrew:

brew update
brew upgrade pocketd

If it's still not working, try:

brew tap --repair
brew untap pokt-network/poktroll
brew uninstall pocketd
brew tap pokt-network/poktroll
brew install pocketd

The source code for the Homebrew formula can be found at homebrew-pocketd.


3. Alternative Methods

Using release binaries

TL;DR manual download
  • Download the binary from the latest release
  • Choose the correct pocket_${OS}_${ARCH}.tar.gz for your system
  • Untar and move the binary to /usr/local/bin
# Download the correct binary for your OS and architecture
curl -LO "https://github.com/pokt-network/poktroll/releases/latest/download/pocket_$(uname | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz"

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

# Make it executable
sudo chmod +x /usr/local/bin/pocketd

# Check version
pocketd version

Additional references and links:

  • Pre-built binaries can be found on the releases page
  • Latest release can be found here

From Source (danger zone)

warning

Do not continue unless you're a 🚀👨‍💻💎

For ADVANCED users only. Requires developer tools.

Installation dependencies

Build from source

# Clone the repository
git clone https://github.com/pokt-network/poktroll.git pocket
cd pocket

# Optional: Checkout a specific version (recommended)
# Replace v0.0.12 with your desired version from https://github.com/pokt-network/poktroll/releases
git checkout v0.0.12

# Build the binary
make go_develop
make ignite_pocketd_build

Verify installation:

pocketd version
pocketd --help

4. Windows (why!?)

danger