> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/cli/readme.md).

# 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

```bash
# 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