# 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
* **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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acecloud.ai/knowledge-base/cli/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.