Huawei Cloud Billing Scout

# Huawei Cloud KooCLI Installation Guide



## Overview

Huawei Cloud KooCLI (hcloud) is the official Huawei Cloud command-line tool that supports managing 100+ cloud services. This guide provides complete installation, configuration, and verification processes.



## Version Requirements

- **Minimum version**: One major version before the latest major version (e.g., if current is 7.x.x, then not lower than 6.x.x)

- **Latest version**: Refer to https://support.huaweicloud.com/wtsnew-hcli/index.html

- **Verification command**: `hcloud version`

- **Update command**: `hcloud update`



## Quick Installation (All Platforms)



### One-click Installation

```bash

# Download and run official installation script (interactive)

curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh



# Non-interactive installation (skip confirmation)

curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh -y

```



### Verify Installation

```bash

# Check version

hcloud version

# Expected output: Current KooCLI version: 7.2.2



# Check help

hcloud --help

```



## Installation Methods for Each Platform



### 1. Linux Systems



#### Detect System Architecture

```bash

echo $HOSTTYPE

# x86_64: AMD 64-bit system

# aarch64: ARM 64-bit system

```



#### Step-by-step Installation

```bash

# AMD 64-bit system

curl -LO "https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/huaweicloud-cli-linux-amd64.tar.gz"

tar -zxvf huaweicloud-cli-linux-amd64.tar.gz

sudo mv hcloud /usr/local/bin/



# ARM 64-bit system

curl -LO "https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/huaweicloud-cli-linux-arm64.tar.gz"

tar -zxvf huaweicloud-cli-linux-arm64.tar.gz

sudo mv hcloud /usr/local/bin/

```



### 2. macOS Systems



#### Detect System Architecture

```bash

echo $HOSTTYPE

# If empty, use:

uname -a

# x86_64: AMD 64-bit system (Intel chips)

# arm64: ARM 64-bit system (Apple Silicon)

```



#### Step-by-step Installation

```bash

# Intel chips (AMD 64-bit)

curl -LO "https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/huaweicloud-cli-mac-amd64.tar.gz"

tar -zxvf huaweicloud-cli-mac-amd64.tar.gz

sudo mv hcloud /usr/local/bin/



# Apple Silicon (ARM 64-bit)

curl -LO "https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/huaweicloud-cli-mac-arm64.tar.gz"

tar -zxvf huaweicloud-cli-mac-arm64.tar.gz

sudo mv hcloud /usr/local/bin/

```



### 3. Windows Systems



#### Installation Steps

1. Download: https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/huaweicloud-cli-windows-amd64.zip

2. Extract ZIP file to get `hcloud.exe`

3. Add the directory containing `hcloud.exe` to PATH environment variable



#### Verify Installation

```cmd

hcloud version

# Expected output: Current KooCLI version: 7.2.2

```



### 4. Docker Environment



#### Using Official Image

```bash

# Pull and run

docker run --rm -it swr.cn-north-4.myhuaweicloud.com/huawei-cloud/koocli:latest version

```



#### Custom Image

```dockerfile

FROM ubuntu:latest

RUN apt-get update -y && apt-get install curl -y

RUN curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh -y

WORKDIR /workspace

ENTRYPOINT ["/usr/local/bin/hcloud"]

```



Build and use:

```bash

# Build image

docker build -t hcloudcli .



# Run command

docker run --rm -it hcloudcli version

```



## Post-installation Configuration



### Auto-completion Configuration

```bash

# Enable auto-completion

hcloud auto-complete on



# Reload shell configuration

# Bash: source ~/.bashrc

# Zsh: source ~/.zshrc

```



### Multi-environment Configuration

```bash

# Create development environment configuration