Install/Update ESA CLI

ESA CLI is a command-line tool for building with Alibaba Cloud ESA Functions and Pages.

Install ESA CLI

Prerequisites

• Node.js: 20.x or higher (supports 20.x, 22.x)
• OS: macOS (x86, Apple Silicon), Linux
• Recommended to use a Node version manager like Volta or nvm to avoid permission issues and easily switch Node.js versions.

Installation

To ensure consistent collaboration across your team, we recommend installing esa-cli as a dev dependency in your project. This helps everyone use the same version.

npm i -D esa-cli@latest

Alternatively, install globally to use the esa-cli command system-wide:

npm i -g esa-cli@latest

[!TIP] When esa-cli is not previously installed, npx will fetch and run the latest version from the registry.

Check your ESA CLI version

To check your ESA CLI version, run:

npx esa-cli --version
# or
npx esa-cli -v

Update ESA CLI

To update ESA CLI to the latest version, run:

npm i -D esa-cli@latest

Related Documentation

• esa-cli command
• ESA Configuration Guide
• Alibaba Cloud ESA Documentation
• Functions and Pages API Reference