Skip to main content

Installation

Requirements​

  • Homebrew on macOS for the recommended installation method.
  • Go 1.25 or later only when building from source.
  • Alibaba Cloud credentials for commands that call cloud APIs.
  • Optional: an existing compatible aliyun CLI configuration file.

Install with Homebrew​

Install the latest public release:

brew tap aliyun/ecctl https://github.com/aliyun/elastic-compute-control-cli
brew install ecctl
ecctl --version

The first command explicitly uses this repository as the aliyun/ecctl Tap. To upgrade an existing installation:

ecctl update

ecctl update supports both Homebrew and direct binary installations. You do not need to run brew update first. See Updates for version checks, explicit versions, and automatic notifications.

Download a Pre-built Binary​

Download the archive for your operating system and architecture from GitHub Releases, then extract ecctl and place it on your PATH.

Verify the installation:

ecctl --version
ecctl --help

Build from Source​

Clone the repository and build from its root:

git clone https://github.com/aliyun/elastic-compute-control-cli.git
cd elastic-compute-control-cli
make build

The binary is written to bin/ecctl.

Verify it:

./bin/ecctl --version
./bin/ecctl --help