Skip to main content
The InstaPods CLI (instapods) is a single binary that lets you deploy and manage apps from the terminal. It’s designed for developers and AI agents.

​
Install

curl -fsSL https://instapods.com/install.sh | sh
This auto-detects your OS and architecture, verifies the SHA256 checksum, and installs to /usr/local/bin (or ~/.local/bin if you don’t have sudo).

​
Verify Installation

instapods version
Prints the CLI version, git commit, build date, and OS/architecture.

​
Self-Update

instapods update
Checks for the latest version, downloads the new binary, verifies its checksum, and replaces the current binary in-place. Use --force to skip the version check or update dev builds.

​
Configuration

The CLI stores its configuration at ~/.instapods/config.json: 
{
  "token": "your-auth-token",
  "api_url": "https://app.instapods.com",
  "team_id": "your-team-id"
}

​
API URL Priority

The CLI resolves the API URL in this order:
  1. --api flag (e.g., instapods --api http://localhost:7070 pods list)
  2. INSTAPOD_API environment variable
  3. Value from ~/.instapods/config.json
  4. Default: https://app.instapods.com

​
Global Flags

These flags are available on every command:
FlagDescription
--apiOverride the API URL
--jsonOutput in JSON format

​
Available Commands

The CLI organizes commands into groups:
GroupCommands
Authenticationlogin, whoami, logout
Catalogpresets, plans, regions
Pod Managementpods, deploy
Pod Operationsexec, ssh, ssh-keys, files, services, logs
Utilitiesversion, update, completion

​
Shell Completion

The CLI supports shell completion for bash, zsh, fish, and PowerShell: 
# Bash
instapods completion bash > /etc/bash_completion.d/instapods

# Zsh
instapods completion zsh > "${fpath[1]}/_instapods"

# Fish
instapods completion fish > ~/.config/fish/completions/instapods.fish

​
Next Steps