Install, update, and uninstall Alibaba Cloud CLI

Install by using a Bash script (recommended)

Install by using a TGZ package (.tar.gz)

Install by using Homebrew (recommended)

brew install aliyun-cli

Install by using the graphical interface (PKG)

Double-click to install. No command-line tool is required.

1. Download the installation package.

   • Download the latest version: Open the download link https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg in your browser to download the latest installation package.

   • Download a specific version: Visit the GitHub Releases page to view and download historical installation packages.

     For macOS, the PKG (macOS Installer Package, .pkg) installation package name follows the format aliyun-cli-<version>.pkg.

2. Double-click the downloaded installation package and follow the on-screen instructions to complete the installation.

Install by using a Bash script

The installation commands are the same as on Linux. For parameter descriptions, see the "Install by using a Bash script" method for Linux.

• Install the latest version

  /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"

• Install a specific version

  Important

  For version requirements, see the "Version information" section.

  /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -- -V 3.5.1

Install by using a TGZ package (.tar.gz)

1. Download the installation package.

   • Download the latest version:

     curl https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz -o aliyun-cli-macosx-latest-universal.tgz

   • Download a specific version: Visit the GitHub Releases page to download historical installation packages.

     For macOS, the installation package name follows the format aliyun-cli-macosx-<version>-universal.tgz.

     Important

     For version requirements, see the "Version information" section.

2. Extract the installation package to obtain the aliyun executable.

   tar xzvf aliyun-cli-macosx-latest-universal.tgz

3. Move the executable to the /usr/local/bin directory so that the aliyun command can run from any path.

   sudo mv ./aliyun /usr/local/bin/

Install by using the graphical interface (GUI)

Install by using a PowerShell script

1. Create a script file named Install-CLI-Windows.ps1. You can run New-Item Install-CLI-Windows.ps1 in PowerShell to create it, or create a text document in File Explorer and rename it.

2. Copy the following code and save it to the script file.

   Sample script

   # Install-CLI-Windows.ps1
   # Purpose: Install Alibaba Cloud CLI on Windows AMD64 systems.
   # Supports custom version and install directory. Only modifies User-level and Process-level PATH.
   
   [CmdletBinding()]
   param (
       [string]$Version = "latest",
       [string]$InstallDir = "$env:LOCALAPPDATA",
       [switch]$Help
   )
   
   function Show-Usage {
       Write-Output @"
   
         Alibaba Cloud Command Line Interface Installer
   
       -Help                 Display this help and exit
   
       -Version VERSION      Custom CLI version. Default is 'latest'
   
       -InstallDir PATH      Custom installation directory. Default is:
                             $InstallDir\AliyunCLI
   
   "@
   }
   
   function Write-ErrorExit {
       param([string]$Message)
       Write-Error $Message
       exit 1
   }
   
   if ($PSBoundParameters['Help']) {
       Show-Usage
       exit 0
   }
   
   Write-Output @"
   ..............888888888888888888888 ........=8888888888888888888D=..............
   ...........88888888888888888888888 ..........D8888888888888888888888I...........
   .........,8888888888888ZI: ...........................=Z88D8888888888D..........
   .........+88888888 ..........................................88888888D..........
   .........+88888888 .......Welcome to use Alibaba Cloud.......O8888888D..........
   .........+88888888 ............. ************* ..............O8888888D..........
   .........+88888888 .... Command Line Interface(Reloaded) ....O8888888D..........
   .........+88888888...........................................88888888D..........
   ..........D888888888888DO+. ..........................?ND888888888888D..........
   ...........O8888888888888888888888...........D8888888888888888888888=...........
   ............ .:D8888888888888888888.........78888888888888888888O ..............
   "@
   
   $OSArchitecture = (Get-WmiObject -Class Win32_OperatingSystem).OSArchitecture
   
   $ProcessorArchitecture = [int](Get-WmiObject -Class Win32_Processor).Architecture
   
   if (-not ($OSArchitecture -match "64") -or $ProcessorArchitecture -ne 9) {
       Write-ErrorExit "Alibaba Cloud CLI only supports Windows AMD64 systems. Please run on a compatible system."
   }
   
   $DownloadUrl = "https://aliyuncli.alicdn.com/aliyun-cli-windows-$Version-amd64.zip"
   
   $tempPath = $env:TEMP
   $randomName = -join ((65..90) + (97..122) + (48..57) | Get-Random -Count 8)
   $DownloadDir = Join-Path -Path $tempPath -ChildPath $randomName
   New-Item -ItemType Directory -Path $DownloadDir | Out-Null
   
   try {
       $InstallDir = Join-Path $InstallDir "AliyunCLI"
       if (-not (Test-Path $InstallDir)) {
           New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null
       }
   
       $ZipPath = Join-Path $DownloadDir "aliyun-cli.zip"
       Start-BitsTransfer -Source $DownloadUrl -Destination $ZipPath
   
       Expand-Archive -Path $ZipPath -DestinationPath $DownloadDir -Force
   
       Move-Item -Path "$DownloadDir\aliyun.exe" -Destination "$InstallDir\" -Force
   
       $Key = 'HKCU:\Environment'
       $CurrentPath = (Get-ItemProperty -Path $Key -Name PATH).PATH
   
       if ([string]::IsNullOrEmpty($CurrentPath)) {
           $NewPath = $InstallDir
       } else {
           if ($CurrentPath -notlike "*$InstallDir*") {
               $NewPath = "$CurrentPath;$InstallDir"
           } else {
               $NewPath = $CurrentPath
           }
       }
   
       if ($NewPath -ne $CurrentPath) {
           Set-ItemProperty -Path $Key -Name PATH -Value $NewPath
           $env:PATH += ";$InstallDir"
       }
   } catch {
       Write-ErrorExit "Failed to install Alibaba Cloud CLI: $_"
   } finally {
       Remove-Item -Path $DownloadDir -Recurse -Force | Out-Null
   }

3. Run the script file to install Alibaba Cloud CLI by referring to the following examples.

   Note

   The example script path is C:\Example\Install-CLI-Windows.ps1. Replace the script path with the actual location before you run the command.

   • If you do not specify a version, the script automatically installs the latest version. The default installation path is C:\Users\<USERNAME>\AppData\Local\AliyunCLI.

     powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1

   • Use the -Version and -InstallDir options to specify the installation version and directory. Visit the GitHub Releases page to view available historical versions.

     powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1 -Version 3.5.1 -InstallDir "C:\ExampleDir\AliyunCLI"