Introduction

The AceCloud CLI (ace) is a command-line tool for managing your AceCloud infrastructure. Create and manage instances, volumes, VPCs, load balancers, Kubernetes clusters, container deployments, and more — all from your terminal.

Features

• Full infrastructure management — instances, volumes, VPCs, routers, security groups, floating IPs, load balancers

• Spot instances — ace spot runs workloads on spare capacity at a lower hourly price

• Kubernetes — cluster lifecycle, node pools, kubeconfig, version management

• Container Deployments (CaaS) — shared and dedicated container deployments with autoscaling

• Container Registry (CRaaS) — private container registry with vulnerability scanning

• Multiple output formats — table (default), JSON, YAML

• Global overrides — --project and --region flags on every command

• Self-update — ace update keeps you on the latest version

Quick Example

# Login
ace auth login-token --token <your-token>

# Create infrastructure
ace vpc create --name my-vpc --subnet-name my-subnet --subnet-cidr 10.0.0.0/24
ace security-group create --name my-sg
ace sg rule-add --sg <sg-id> --protocol ssh

# Launch an instance
ace instance create --name my-vm \
  --flavor C4i.medium \
  --image Ubuntu-24.04-LTS \
  --network <vpc-id> \
  --security-group <sg-id>

# Check everything
ace get-all

System Requirements

• Linux (amd64/arm64) or macOS (Intel/Apple Silicon)

• Internet connectivity to AceCloud API

• An AceCloud account with a developer token

Getting Help

• ace --help — list all commands

• ace <command> --help — help for any specific command

• ace <command> <subcommand> --help — help for subcommands