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)
- 2. Homebrew (MacOS only)
- 3. Alternative Methods
- 4. Windows (why!?)
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
- Go (v1.23+)
- Make
- Ignite CLI
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
- Native Windows installation is not supported.
- Use Windows Subsystem for Linux (WSL)
- Follow the Linux install instructions above.