pocketd 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)
- Works on both Linux and MacOS.
- Easiest, fastest way to get started.
curl -sSL https://raw.githubusercontent.com/pokt-network/poktroll/main/scripts/install.sh | bash
Verify installation:
pocketd version
pocketd --help
2. Homebrew (MacOS)
- For MacOS users who prefer Homebrew.
Prerequisite: Make sure you have Homebrew installed.
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 still not working, try:
brew tap --repair
brew untap pokt-network/poktroll
brew uninstall pocketd
brew tap pokt-network/poktroll
brew install pocketd
- Source code for the Homebrew formula: homebrew-pocket
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
- Pre-built binaries: releases page
- Latest release: here
From Source (danger zone)
warning
Do not continue unless you're a 🚀👨💻💎
For ADVANCED users only. Requires developer tools.
Installing 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.