# Install aliyun-cli with Homebrew, Nix, pacman, winget, zypper, scoop Universal Command-Line Interface for Alibaba Cloud. Version 3.4.5 via Homebrew; verified 2026-07-07. ## Install ```sh sudo av install brew:aliyun-cli ``` ## Agent safety answer aliyun-cli controls Alibaba Cloud resources from local credentials. - **Credential access:** Reads Alibaba Cloud access keys, profiles, and environment credentials. - **Remote mutation:** Can create, delete, and modify cloud resources. - **Publish/artifact risk:** Can deploy infrastructure and upload artifacts to cloud services. - **Recommended control:** Gate mutating aliyun commands and credential access. - **Agent-use guidance:** Allow read-only listing; require approval for writes, deletes, and deploys. Additional install commands: ### macOS - Homebrew (100%): ```sh brew install aliyun-cli ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#aliyun-cli ``` Evidence: nixpkgs package indexes: pkgs/by-name/al/aliyun-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S aliyun-cli ``` Evidence: Arch Linux sync databases: aliyun-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install aliyun-cli ``` Evidence: openSUSE Tumbleweed package metadata: aliyun-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - winget (92%): ```sh winget install --id Alibaba.AlibabaCloudCLI -e ``` Evidence: Windows Package Manager source index: Alibaba.AlibabaCloudCLI from https://cdn.winget.microsoft.com/cache/source.msix - Scoop (92%): ```sh scoop install main/aliyun ``` Evidence: Scoop official bucket manifest trees: bucket/aliyun.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:aliyun-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.4.5 - **Source summary:** Universal Command-Line Interface for Alibaba Cloud - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-07T15:33:34Z - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - aliyun (cli) - aliyun (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-09 - Package-manager version: 3.4.5 - Package-manager updated: 2026-07-07 - Local data: ok - Upstream repository: https://github.com/aliyun/aliyun-cli - Upstream latest detected: v3.4.5 (current) ## Project history and usage Alibaba Cloud CLI is Alibaba Cloud's open-source command-line interface for managing Alibaba Cloud resources through OpenAPI. ### Project history The public repository begins in git history on 2015-06-30. The current README describes the CLI as a Go tool built on top of Alibaba Cloud OpenAPI and distributed through GitHub releases, platform installers, a one-line installer, and package managers. The changelog records a v0.1 entry dated 2018-01-11 with a Go refactoring, basic configuration, and automatic endpoint location. Later pre-v3 entries added richer configuration commands, authentication modes, completion, paging, ossutil integration, and v3.0.0 GA refactoring. ### Adoption history The README explicitly supports trying the CLI in Alibaba Cloud Shell before local installation, which gives it both a hosted-cloud and local-terminal path. It documents Homebrew installation, direct downloads for macOS, Linux, and Windows, and links to GitHub releases. The input package-manager facts show broad downstream packaging: Homebrew, Nix, pacman, Scoop, winget, and zypper. ### How it is used Users normally start with aliyun configure, which writes profile data including credentials, region, output format, and language. The README documents authentication modes including AK, RAM role ARN, ECS RAM role, OIDC, external credential process, CredentialsURI, chainable RAM role ARN, and CloudSSO. Once configured, the aliyun executable invokes Alibaba Cloud OpenAPI actions and product commands from the terminal, with troubleshooting support tied to RequestID or error messages. ### Why package nerds care aliyun-cli is the canonical terminal entry point for Alibaba Cloud automation. For package maintainers, it is a multi-platform cloud CLI with real credential storage, release assets, shell completion, and frequent cloud-service surface changes. ### Timeline - 2015: Public Git history begins. - 2018: Changelog records v0.1 with Go refactoring and basic configuration. - 2018: v3.0.1 tag exists in repository history. - 2026: v3.4.2 tag appears in repository history. ### Related projects - Alibaba Cloud OpenAPI: service interface layer used by the CLI. - ossutil: object-storage toolset integrated according to the changelog. ### Sources - Git history from https://github.com/aliyun/aliyun-cli.git - Official README: https://raw.githubusercontent.com/aliyun/aliyun-cli/master/README.md - Official changelog: https://raw.githubusercontent.com/aliyun/aliyun-cli/master/CHANGELOG.md - source_facts.package-manager ## Security Notes infrastructure mutation or orchestration signal. - **Geiger risk:** orange / medium - infrastructure mutation or orchestration signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.aliyun/config.json ## Credential files - Unix: ~/.aliyun/config.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** aliyun-cli - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - aliyun-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/al/aliyun-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman - aliyun-cli - 3.3.22-1: normalized package name match | Arch Linux sync databases: aliyun-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Alibaba Cloud CLI | https://github.com/aliyun/aliyun-cli - zypper - aliyun-cli - 3.3.22-1.1: normalized package name match | openSUSE Tumbleweed package metadata: aliyun-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Alibaba Cloud CLI | https://github.com/aliyun/aliyun-cli - winget - Alibaba.AlibabaCloudCLI: normalized package name match | Windows Package Manager source index: Alibaba.AlibabaCloudCLI from https://cdn.winget.microsoft.com/cache/source.msix - Scoop - main/aliyun: installed executable or alias match | Scoop official bucket manifest trees: bucket/aliyun.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [aiven-client](https://www.automicvault.com/pkg/brew/aiven-client/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [firebase-cli](https://www.automicvault.com/pkg/brew/firebase-cli/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [linode-cli](https://www.automicvault.com/pkg/brew/linode-cli/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [openstackclient](https://www.automicvault.com/pkg/brew/openstackclient/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [scw](https://www.automicvault.com/pkg/brew/scw/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [akamai](https://www.automicvault.com/pkg/brew/akamai/) - Shares av.db curated category or tags: cli, cloud-infrastructure. - [filen-cli](https://www.automicvault.com/pkg/brew/filen-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure. - [firefly](https://www.automicvault.com/pkg/brew/firefly/) - Shares av.db curated category or tags: cli, cloud-infrastructure. - [cntb](https://www.automicvault.com/pkg/brew/cntb/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, command-line, infrastructure. - [hcloud](https://www.automicvault.com/pkg/brew/hcloud/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, command-line, infrastructure. - [s4cmd](https://www.automicvault.com/pkg/brew/s4cmd/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, command-line, infrastructure. ## Combined YAML source View the package source record on GitHub. [combined/aliyun-cli.yml](https://github.com/automic-vault/db/blob/main/combined/aliyun-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer