# Install ucloud with Homebrew Official tool for managing UCloud services. Version 0.3.5 via Homebrew; verified 2026-07-07. ## Install ```sh sudo av install brew:ucloud ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install ucloud ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:ucloud - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.3.5 - **Source summary:** Official tool for managing UCloud services - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-07T13:08:35Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - ucloud (cli) - ucloud (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-08 - Package-manager version: 0.3.5 - Package-manager updated: 2026-07-07 - Local data: ok - Upstream repository: https://github.com/ucloud/ucloud-cli - Upstream latest detected: v0.3.5 (current) ## Project history and usage UCloud CLI is the official command-line interface for UCloud services. The project positions the tool as a unified CLI built on UCloud's Go SDK and OpenAPI, with supported builds for Linux, macOS, and Windows. ### Project history The public GitHub repository was created in 2018 and early release tags began at 0.1.1 in August 2018. Its changelog shows steady incremental releases focused on UCloud product coverage, UHost operations, generic API calls, cloud-shell adaptation, and later authentication improvements. ### Adoption history Within package-manager culture, UCloud CLI is primarily an operational tool for users of one cloud provider rather than a general cloud abstraction. Its README explicitly documents Homebrew installation for macOS and Linux, source builds, binary releases, Docker usage, and shell completion. ### How it is used The CLI is used to initialize UCloud profiles, store project, region, zone, API endpoint, retry, and key settings under the user's home directory, and then manage UCloud services from scripts or terminals. Recent changelog entries add OAuth browser login for interactive users while preserving AK/SK profile support for scripts and CI. ### Why package nerds care For package nerds, the interesting point is that this is an official cloud CLI with a conventional Homebrew formula, cross-platform binary releases, completion support, and local profile files. It behaves like the small-provider counterpart to larger cloud CLIs, useful when reproducible terminal setup matters more than web-console workflows. ### Timeline - 2018: GitHub repository created and 0.1.1 release published. - 2020: UHost creation gained user-data and GPU-related flags. - 2022: Generic signature and multi-region listing improvements appear in the changelog. - 2024: UHost creation gained SSH key pair and security group support. - 2026: OAuth browser login and safer config/credential writes were added in 0.3.1. ### Related projects - The README says UCloud CLI works on ucloud-sdk-go and UCloud OpenAPI. - The package sits in the same CLI niche as provider-specific tools such as awscli, gcloud, and aliyun-cli, but the cited sources only document its UCloud scope. ### Sources - - - - source_facts.repo ## 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: ~/.ucloud/config.json ## Credential files - Unix: ~/.ucloud/credential.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** ucloud - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure 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. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [hcloud](https://www.automicvault.com/pkg/brew/hcloud/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-cli, cloud-infrastructure. - [osc-cli](https://www.automicvault.com/pkg/brew/osc-cli/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-cli, cloud-infrastructure. - [doctl](https://www.automicvault.com/pkg/brew/doctl/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-infrastructure, cloud-management. - [oci-cli](https://www.automicvault.com/pkg/brew/oci-cli/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure. - [aiven-client](https://www.automicvault.com/pkg/brew/aiven-client/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [aliyun-cli](https://www.automicvault.com/pkg/brew/aliyun-cli/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [apache-brooklyn-cli](https://www.automicvault.com/pkg/brew/apache-brooklyn-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cloud-management. - [azion](https://www.automicvault.com/pkg/brew/azion/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. ## Combined YAML source View the package source record on GitHub. [combined/ucloud.yml](https://github.com/automic-vault/db/blob/main/combined/ucloud.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 - cross-ecosystem install command graph