Updated on 2026-04-16 GMT+08:00

Installing the Client on an SC

Scenario

This section describes how to install and run the Huawei Cloud Workspace client on an SC.

Preparations

  • Obtain the installation package of the corresponding operating system from the download address in the email or download the client.
    • The notification emails are slightly different depending on whether the AD is interconnected. Refer to the actual notification email.
    • If no email server is available, you cannot receive the desktop login email. In this case, contact the administrator to obtain the desktop login information and download and install the client by referring to Table 1.
  • A PC running any of the following operating systems is available, as shown in Table 1.
    Table 1 Client type description

    System Type

    Software Name

    Description

    Windows

    Workspace_Win.msi

    PCs running Windows 10 or Windows 11 (64-bit)

    macOS

    Workspace_mac.dmg

    macOS 10.14 to 15.2

    Kylin

    Workspace_amd64.deb

    AMD64: PCs running Zhaoxin + Kylin V10 or Hygon + Kylin V10 SP1 operating systems

    Workspace_arm64.deb

    ARM64: PCs running Kunpeng + Kylin V10 or Phytium 2000 + Kylin V10 operating systems

    UOS

    Workspace_uos_amd64.deb

    AMD64: PCs running Zhaoxin + UOS V20 or Hygon + UOS V20, or HT6300 series TCs

    Workspace_uos_arm64.deb

    ARM64: PCs running Kunpeng + UOS V20 or Phytium 2000 + UOS V20, or HT3300/HT3300H series TCs

    Ubuntu

    Workspace_amd64.deb

    PCs running x86 processors and Ubuntu 20.04 or 22.04 operating systems

Installing the Client in the Windows OS

  1. Double-click the downloaded Workspace_Win.msi software package.
  2. Complete the installation as prompted.

    Important notes for installing the cloud client on a Windows PC:

    • The user who logs in to the Windows PC has administrator permissions.
    • On the Windows PC, the available space of drive C must be greater than 500 MB, the memory must be greater than or equal to 2 GB, and the CPU frequency must be greater than or equal to 2.0 GHz.
    • When security software displays a dialog box, allow the installation to continue.

Installing the Client in macOS

  1. On the Mac, double-click the downloaded Workspace_mac.dmg software package. The installation configuration window is displayed.
  2. Double-click the installation icon.
  3. Click Continue.
  4. Click Install.

    If you do not want to install the client in the default location, click Change Install Location.

  5. In the displayed window, enter the username and password, and click Install Software.

    The installation takes about one minute.

  6. Click Close.

Installing the Client in the Kylin\UOS\Ubuntu OS

GUI-based installation

  1. In the installation package directory, double-click the Workspace.xxxx.deb installation package and enter the user password as prompted.

CLI-based installation

  1. Right-click in the blank area on the user computer and choose Open Terminal from the shortcut menu.

    The CLI is displayed.

  2. Run the following command to switch to the root user:

    su - root

  3. Run the following command to switch to the directory of the installation package:

    cd Directory of the installation package

    Example: cd /home/username/Desktop

  4. Run the following command to set the read and write permissions on the installation package:

    chmod 777 <installation-package-name>

    Example:

    chmod 777 Workspace_arm64.deb

  5. Run the following command to install the software client:

    dpkg -i <installation-package-name>

    Example: dpkg -i Workspace_arm64.deb

Starting the Client

  • If a macOS PC is used, you need to set the system preference before starting the client for the first time. Otherwise, you cannot enter characters on the cloud desktop. Choose System Preferences > Security & Privacy > Input Monitoring, select HDPViewer, and switch the input mode to English.
  • If an Ubuntu PC is used, the client is displayed as an application after being installed. Right-click the application and select the startup option. Then, the application is started.