Alibaba Cloud CLI:Install, update, and uninstall Alibaba Cloud CLI

Use a Bash script

The script detects your architecture, downloads the correct package, and places the aliyun binary in /usr/local/bin/.

• Install the latest version

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

• Install a specific version

  Check GitHub Releases for available versions.

  Important

  Versions earlier than 3.3.0 are end-of-life and no longer receive updates or security fixes.

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

Use a TGZ package (compressed tar archive)

1. Download the installation package that matches your system architecture.

   Note

   Run uname -m to check your architecture. arm64 or aarch64 indicates ARM64. Other output indicates AMD64.

   • Download for Linux AMD64:

     curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o aliyun-cli-linux-latest.tgz

   • Download for Linux ARM64:

     curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-arm64.tgz -o aliyun-cli-linux-latest.tgz

   • Download a specific version: Visit the GitHub Releases page. The package name format is aliyun-cli-linux-<version>-<architecture>.tgz.

     Important

     Versions earlier than 3.3.0 are end-of-life and no longer receive updates or security fixes.

2. Extract the package to obtain the aliyun binary.

   tar xzvf aliyun-cli-linux-latest.tgz

3. Move the binary to /usr/local/bin for global access.

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

Use a graphical installer (GUI, recommended)

1. Download the PKG (macOS installer package).

   • Latest version: Download the PKG installer: https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg

   • Specific version: Visit the GitHub Releases page. The PKG name format is aliyun-cli-<version>.pkg.

     Important

     Versions earlier than 3.3.0 are end-of-life and no longer receive updates or security fixes.

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

   Note

   If macOS blocks the installer with a security warning, open System Settings > Privacy & Security and click Open Anyway to proceed.

Use Homebrew

brew install aliyun-cli

Use a Bash script

The script detects macOS and downloads the universal binary automatically.

• Install the latest version

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

• Install a specific version

  Check GitHub Releases for available versions.

  Important

  Versions earlier than 3.3.0 are end-of-life and no longer receive updates or security fixes.

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

Use a TGZ package

1. Download the installation package.

   • Latest version:

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

   • Specific version: Visit the GitHub Releases page. The package name format is aliyun-cli-macosx-<version>-universal.tgz.

     Important

     Versions earlier than 3.3.0 are end-of-life and no longer receive updates or security fixes.

2. Extract the package to obtain the aliyun binary.

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

3. Move the binary to /usr/local/bin for global access.

   sudo mv ./aliyun /usr/local/bin

Use a ZIP package

1. Download the installation package.

   • Latest version: Download the ZIP package: https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip

   • Specific version: Visit the GitHub Releases page. The package name format is aliyun-cli-windows-<version>-amd64.zip.

     Important

     Versions earlier than 3.3.0 are end-of-life and no longer receive updates or security fixes.

2. Extract aliyun.exe from the ZIP file to a directory of your choice. This directory serves as the Alibaba Cloud CLI installation directory.

   Note

   Run aliyun.exe from a command-line terminal. Double-clicking the executable has no effect.

3. Press Windows + S to open the Windows search bar, then type "environment variables".

4. In the search results, click Edit the environment variables for your account to open the Environment Variables dialog box.

5. Under User variables, select the Path variable, and then click Edit.

   

6. Click New, and enter the Alibaba Cloud CLI installation directory path. For example: C:\ExampleDir (replace with your actual installation path).

   

7. Click OK in each open dialog box to save the changes.

8. Restart your terminal for the changes to take effect.

Use a PowerShell script

1. Create a file named Install-CLI-Windows.ps1 and paste the following script into it.

   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
   }

2. Run the script to install Alibaba Cloud CLI.

   Note

   The example script path is C:\Example\Install-CLI-Windows.ps1. Replace it with your actual script path.

   • Install 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

   • Specify a version (from GitHub Releases) and installation directory.

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

Use the command line

1. Remove the aliyun binary:

   sudo sh -c "which aliyun | xargs -r rm -v"

2. If you installed to a custom directory, remove that directory from the PATH environment variable. Open your shell configuration file (for example, ~/.bashrc for Bash or ~/.zshrc for Zsh) and delete the line that adds the Alibaba Cloud CLI directory to PATH. Then reload the configuration:

   source ~/.bashrc

   Note

   Replace ~/.bashrc with ~/.zshrc if your default shell is Zsh.

Use a Bash script

1. Create a script file and paste the following content into it.

   Sample script

   #!/usr/bin/env bash
   
   set -euo pipefail
   
   show_help() {
   cat << EOF
   
         Alibaba Cloud Command Line Interface Uninstaller
   
       -h          Display this help and exit
   
       -C          Remove user config file
   
   EOF
   }
   
   abort() {
     printf "%s\n" "$@" >&2
     exit 1
   }
   
   CLEAN_CONFIG=false
   
   while getopts ":hC" opt; do
     case "$opt" in
       "h")
         show_help
         exit 0
         ;;
       "C")
         CLEAN_CONFIG=true
         ;;
       *)
         echo "Unexpected flag not supported"
         exit 1
         ;;
     esac
   done
   
   echo -e "
   ..............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 ..............
   "
   
   USER_CONFIG_DIR="${HOME}/.aliyun"
   CONFIG_FILE_PATH="${USER_CONFIG_DIR}/config.json"
   
   remove_aliyun_binary() {
     local binary
     binary=$(which aliyun)
   
     if [ -n "$binary" ]; then
       rm -vf "$binary"
       rmdir --ignore-fail-on-non-empty "$(dirname "$binary")" 2>/dev/null || true
     fi
   }
   
   remove_user_config() {
     if $CLEAN_CONFIG; then
       rm -f "${CONFIG_FILE_PATH}" || abort "Failed to remove config file: ${CONFIG_FILE_PATH}"
   
       if [ -d "${USER_CONFIG_DIR}" ]; then
         rmdir --ignore-fail-on-non-empty "${USER_CONFIG_DIR}" 2>/dev/null || true
       fi
     fi
   }
   
   remove_aliyun_binary
   remove_user_config
   
   echo "Aliyun CLI has been uninstalled."

2. Run the script:

   # Uninstall only the executable file
   bash <script_path>
   
   # Uninstall the executable file and delete the configuration file
   bash <script_path> -C
   
   # View script help
   bash <script_path> -h

Use Homebrew

Run the following command to uninstall:

brew uninstall aliyun-cli

Use the command line

1. Remove the aliyun binary:

   BINARY=$(which aliyun 2>/dev/null) && [ -n "$BINARY" ] && sudo rm -v "$BINARY"

2. If you installed to a custom directory, remove that directory from the PATH environment variable. Open your shell configuration file (~/.bashrc for Bash or ~/.zshrc for Zsh) and delete the line that adds the Alibaba Cloud CLI directory. Then reload the configuration:

   source ~/.zshrc

   Note

   Replace ~/.zshrc with ~/.bashrc if you use Bash.

Use File Explorer

1. Open File Explorer, navigate to the Alibaba Cloud CLI installation directory, and delete the aliyun.exe file.

2. Press the Windows key, then type "environment variables" in the search box.

3. In the search results, click Edit the environment variables for your account to open the Environment Variables dialog box.

4. Under User variables, select the Path variable, and then click Edit.

   

5. Select the Alibaba Cloud CLI installation directory entry, click Delete to remove it from Path. For example: C:\ExampleDir (replace with your actual installation path).

   

6. Click OK in each open dialog box to save the changes.

Use a PowerShell script

1. Create a script file and paste the following content into it.

   Sample script

   # Uninstall-CLI-Windows.ps1
   # Purpose: Automatically detect and uninstall Aliyun CLI, and delete configuration files in user directory
   
   [CmdletBinding()]
   param (
       [switch]$Clean,
       [switch]$Help
   )
   
   function Show-Usage {
       Write-Output @"
   
         Alibaba Cloud Command Line Interface Uninstaller
   
       -Help                 Display this help and exit
   
       -Clean                Remove user config file
   
   "@
   }
   
   function Remove-DirectoryIfEmpty {
       param([string]$Path)
       if ((Get-ChildItem -Path $Path -Force).Count -eq 0) {
           Remove-Item -Path $Path -Force
       }
   }
   
   function Remove-AliyunCLIFromPath {
       param([string]$PathToRemove)
       $Key = 'HKCU:\Environment'
       $CurrentPath = (Get-ItemProperty -Path $Key -Name PATH).PATH
       if ($CurrentPath -like "*$PathToRemove*") {
           $newPath = ($CurrentPath -split ';' | Where-Object { $_ -ne $PathToRemove }) -join ';'
           Set-ItemProperty -Path $Key -Name PATH -Value $newPath
           $env:PATH = $newPath
       }
   }
   
   function Remove-AliyunCLI {
       $AliyunBinary = (Get-Command aliyun -ErrorAction SilentlyContinue).Source
       if ($AliyunBinary -and (Test-Path $AliyunBinary)) {
           Remove-Item -Path $AliyunBinary -Force
           $AliyunInstallDir = Split-Path -Parent $AliyunBinary
           Remove-DirectoryIfEmpty -Path $AliyunInstallDir
           Remove-AliyunCLIFromPath -PathToRemove $AliyunInstallDir
           Write-Output "Aliyun CLI binary has been removed."
       }
   }
   
   function Remove-ConfigFile {
       $ConfigDir = Join-Path $HOME ".aliyun"
       $ConfigFile = Join-Path $ConfigDir "config.json"
       if (Test-Path $ConfigFile) {
           Remove-Item -Path $ConfigFile -Force
           Remove-DirectoryIfEmpty -Path $ConfigDir
           Write-Output "Aliyun CLI config file has been removed."
       }
   }
   
   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 ..............
   "@
   
   try {
       Remove-AliyunCLI
       if ($PSBoundParameters['Clean']) { Remove-ConfigFile }
       Write-Output "Aliyun CLI has been uninstalled."
   } catch {
       Write-Output "Failed to uninstall Aliyun CLI: $_"
   }

2. Run the script:

   # Uninstall only the executable file
   powershell.exe -ExecutionPolicy Bypass -File <script_path>
   
   # Uninstall the executable file and delete the configuration file
   powershell.exe -ExecutionPolicy Bypass -File <script_path> -Clean
   
   # View script help
   powershell.exe -ExecutionPolicy Bypass -File <script_path> -Help