Introduction

CLI

The IBEE CLI (ibee) lets you manage your cloud resources from the terminal. It’s built on the Python SDK, so every command maps directly to an API endpoint.

Install

$pip install ibee-cli

Requires Python 3.10+. This installs the ibee command.

Authenticate

Create an API token in the portal under Settings → API Tokens, then set two environment variables:

$export IBEE_TOKEN="ibee_live_xxxxxxxxxxxx"
$export IBEE_WORKSPACE_ID="907479"

Both can also be passed per command with --token and --workspace.

Global options

OptionDescription
--tokenAPI token (default: IBEE_TOKEN)
--workspace, -wWorkspace ID (default: IBEE_WORKSPACE_ID)
--devTarget the development gateway (api.ibee.co.in) instead of production
--base-urlOverride the API base URL entirely
--jsonPrint raw JSON instead of a formatted table
--versionShow the CLI version

Object storage

$ibee buckets list
$ibee buckets create my-bucket            # --region defaults to in-south-1
$ibee buckets create my-bucket --public   # unauthenticated read access
$ibee buckets delete my-bucket --yes

Secret store

$ibee secrets stores                      # list secret stores
$ibee secrets list --store-id STORE_ID    # list secrets in a store
$ibee secrets value SECRET_ID             # print a secret's value as JSON

Cloud VMs

$ibee vms list
$ibee vms get VM_ID
$ibee vms start VM_ID
$ibee vms stop VM_ID
$ibee vms reboot VM_ID

GPU VMs

$ibee gpus list
$ibee gpus get VM_ID

JSON output

Add --json to any command for machine-readable output — useful in scripts:

$ibee --json buckets list | jq '.buckets[].name'

Development environment

Use --dev (or IBEE_ENV=dev) with a ibee_dev_key_... token to target the development gateway:

$ibee --dev buckets list