CLI

Manage Podstack resources from your terminal using the official command-line interface.

Overview

The Podstack CLI provides a powerful command-line interface for managing GPU cloud resources. Use it for quick operations, scripting, automation, and CI/CD integration.

Quick Example

# Create a GPU pod
podstack pod create \
  --name training-job \
  --image pytorch/pytorch:latest \
  --gpu-type A100 \
  --wait

# SSH into the pod
podstack pod ssh training-job

# Run a command
podstack pod exec training-job -- nvidia-smi

# Delete when done
podstack pod delete training-job

Features

  • Cross-Platform - Works on macOS, Linux, and Windows
  • Full Coverage - Manage pods, VMs, storage, projects
  • Multiple Outputs - Table, JSON, YAML formats
  • Shell Completion - Tab completion for Bash, Zsh, Fish
  • CI/CD Ready - Token-based auth for automation
  • Fast & Lightweight - Single binary, no dependencies

Installation

# macOS
brew install podstack/tap/podstack-cli

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

# Windows
winget install podstack.cli

In This Section

GuideDescription
InstallationInstall on your platform
AuthenticationLogin and configure access
Quick StartGet started in minutes
PodsContainer management commands
Virtual MachinesVM commands
StorageBucket and volume commands
ConfigurationCLI settings and defaults

Common Commands

CommandDescription
podstack auth loginAuthenticate with Podstack
podstack pod listList all pods
podstack pod createCreate a new pod
podstack pod ssh NAMESSH into a pod
podstack pod delete NAMEDelete a pod
podstack vm listList all VMs
podstack bucket listList storage buckets
podstack wallet balanceCheck wallet balance

Support

For CLI issues, visit Customer Support or check the Troubleshooting guide.

In This Section