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

Use a Bash script (recommended)

The script detects your system 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

  Use the -V flag to specify a version. Check GitHub Releases for available versions.

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

Use a .tar.gz package

1. Download the package that matches your system architecture.

   Note

   Run uname -m to check your architecture. arm64 or aarch64 indicates ARM64; other output indicates x86_64.

   • x86_64 (64-bit):

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

   • ARM64:

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

   • To download a specific version, visit the GitHub Releases page. Package names follow the format aliyun-cli-linux-<version>-<arch>.tgz, where <arch> is amd64 or arm64.

2. Extract the package.

   tar xzvf aliyun-cli-linux-latest.tgz

3. Move the binary to a directory in your PATH.

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

Use Homebrew (recommended)

brew install aliyun-cli

Use the macOS installer (.pkg)

1. Download the installer.

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

   • Specific version: Visit the GitHub Releases page. Installer names follow the format aliyun-cli-<version>.pkg.

2. Double-click the downloaded .pkg file and follow the on-screen instructions.

   Note

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

Use a Bash script

The script detects macOS and downloads the universal binary automatically. The commands are the same as on Linux.

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

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

Use a .tar.gz package

1. Download the 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. Package names follow the format aliyun-cli-macosx-<version>-universal.tgz.

2. Extract the package.

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

3. Move the binary to a directory in your PATH.

   sudo mv ./aliyun /usr/local/bin

Use a ZIP package

1. Download the package.

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

   • Specific version: Visit the GitHub Releases page. Package names follow the format aliyun-cli-windows-<version>-amd64.zip.

2. Extract aliyun.exe to a directory of your choice. For example, C:\AliyunCLI.

   Note

   aliyun.exe is a command-line tool. Double-clicking it has no effect. Run it from a terminal (Command Prompt or PowerShell).

3. Press Windows + S and search for environment variables.

4. Click Edit the environment variables for your account.

5. Under User variables, select Path and click Edit.

   

6. Click New and enter the directory path (for example, C:\AliyunCLI).

   

7. Click OK in each dialog to save.

8. Restart your terminal for the change 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.3.18 -InstallDir "C:\ExampleDir\AliyunCLI"

Use the command line

1. Locate and remove the binary:

   sudo rm -v "$(which aliyun)"

2. If you installed to a custom directory and added it to PATH, remove that entry from your shell configuration file (~/.bashrc for Bash or ~/.zshrc for Zsh) and reload:

   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

Uninstall Alibaba Cloud CLI:

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 and added it to PATH, remove that entry from ~/.zshrc (or ~/.bashrc) and reload:

   source ~/.zshrc

   Note

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

Use File Explorer

1. Navigate to the installation directory and delete aliyun.exe.

2. Press Windows + S and search for environment variables.

3. Click Edit the environment variables for your account.

4. Under User variables, select Path and click Edit.

   

5. Select the Alibaba Cloud CLI directory entry and click Delete.

   

6. Click OK in each dialog to save.

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