Table of contents

Installation

Install the Podstack CLI to manage GPU cloud resources from your terminal.

Quick Install

macOS

Using Homebrew:

brew install podstack/tap/podstack-cli

Or using the install script:

curl -sSL https://get.podstack.ai/cli | bash

Linux

Using the install script:

curl -sSL https://get.podstack.ai/cli | bash

Using apt (Debian/Ubuntu):

# Add repository
curl -fsSL https://apt.podstack.ai/gpg | sudo gpg --dearmor -o /usr/share/keyrings/podstack.gpg
echo "deb [signed-by=/usr/share/keyrings/podstack.gpg] https://apt.podstack.ai stable main" | sudo tee /etc/apt/sources.list.d/podstack.list

# Install
sudo apt update
sudo apt install podstack-cli

Using yum (RHEL/CentOS/Fedora):

# Add repository
sudo tee /etc/yum.repos.d/podstack.repo << 'EOF'
[podstack]
name=Podstack CLI
baseurl=https://yum.podstack.ai/stable
enabled=1
gpgcheck=1
gpgkey=https://yum.podstack.ai/gpg
EOF

# Install
sudo yum install podstack-cli

Windows

Using winget:

winget install podstack.cli

Using Scoop:

scoop bucket add podstack https://github.com/podstack/scoop-bucket
scoop install podstack-cli

Using Chocolatey:

choco install podstack-cli

From Source

Requires Go 1.21+:

go install github.com/podstack/cli@latest

Docker

docker run -it --rm podstack/cli --help

With credentials:

docker run -it --rm \
  -e PODSTACK_API_TOKEN=$PODSTACK_API_TOKEN \
  podstack/cli pod list

Verify Installation

podstack version

Expected output:

Podstack CLI v1.2.3
Build: 2024-01-15

Update CLI

macOS (Homebrew)

brew upgrade podstack-cli

Linux (apt)

sudo apt update && sudo apt upgrade podstack-cli

All Platforms

podstack update

Check for updates:

podstack update --check

Uninstall

macOS (Homebrew)

brew uninstall podstack-cli

Linux (apt)

sudo apt remove podstack-cli

Windows (winget)

winget uninstall podstack.cli

Manual Removal

# Remove binary
sudo rm /usr/local/bin/podstack

# Remove config
rm -rf ~/.podstack

Shell Completion

Enable tab completion for faster command entry.

Bash

# Add to ~/.bashrc
eval "$(podstack completion bash)"

# Or install permanently
podstack completion bash | sudo tee /etc/bash_completion.d/podstack > /dev/null

Zsh

# Add to ~/.zshrc
eval "$(podstack completion zsh)"

# Or install permanently
podstack completion zsh > "${fpath[1]}/_podstack"

Fish

podstack completion fish > ~/.config/fish/completions/podstack.fish

PowerShell

# Add to $PROFILE
podstack completion powershell | Out-String | Invoke-Expression

Troubleshooting

Command Not Found

Add the install directory to your PATH:

# Linux/macOS
export PATH="$HOME/.podstack/bin:$PATH"

# Add to shell profile for persistence
echo 'export PATH="$HOME/.podstack/bin:$PATH"' >> ~/.bashrc

Permission Denied

Make the binary executable:

chmod +x /usr/local/bin/podstack

SSL Certificate Errors

Update CA certificates:

# Ubuntu/Debian
sudo apt update && sudo apt install ca-certificates

# macOS
brew install ca-certificates

Proxy Configuration

Set proxy environment variables:

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

Next Steps