All Products
Search
Document Center

Cloud Backup:Install a backup client

Last Updated:Jan 07, 2026

To back up files from an on-premises server or virtual machine (VM), you must first install the Cloud Backup client. The client supports both Windows and Linux, so ensure you download the version appropriate for your server's operating system.

(Recommended) Use the AccessKey of a RAM user

Resource Access Management (RAM) is Alibaba Cloud's service for centralized identity and access control. It enables you to create and manage multiple user identities under a single account and assign them granular permissions, thereby controlling who has access to specific cloud resources.

Client activation requires an AccessKey pair. However, using your Alibaba Cloud account's AccessKey poses a significant security risk, as its compromise would expose all your cloud resources. Therefore, as a security best practice, use the AccessKey belonging to a RAM user with limited permissions. For more information, see Create a RAM user and Create an AccessKey pair.

Usage notes

  • For optimal backup performance, run the Cloud Backup client on a machine with a 64-bit CPU that has two or more cores and more than 8 GB of available memory.

  • Backup capacity is determined by available memory. For example:

    • 4 GB memory: Supports up to 1 million files (~8 TB total).

    • 16 GB+ memory: Required for backing up tens of millions of files or more.

  • The installation package of the 64-bit Cloud Backup client does not support the ARM64 architecture.

  • Before you install or uninstall the client, check the installation path for the following:

    • If a NAS folder is mounted on the installation path, run the umount command to unmount the NAS folder. This prevents the accidental deletion of NAS files.

    • If the installation path contains other important folders or files, move them to another location to prevent accidental deletion.

  • Before you use Cloud Backup, review its limits, default backup rate, and features available by region. For more information, see Limits, Backup and recovery speeds, Features, and Features by region.

Download and activate a Windows client

  1. Log on to the Cloud Backup console.

  2. In the navigation pane on the left, choose Backup > On-Premises File Backup. In the upper-left corner of the top menu bar, select a region, and then click Add Client.

  3. Download the Windows client.

    image

  4. Install and activate the Windows client.

    1. Double-click the client installation package and select an installation language.

    2. Select an installation path and click Next.

    3. Select Local client connecting to Alibaba Cloud and click Next.

    4. If you want to use a proxy server, enter the proxy server address. Click Next. For more information, see Use an Apache HTTP service to build a proxy server.

      image

    5. Enter the Activation Token and click Next.

    6. Click Install.

      After the client is installed, its Client Status changes to Activated on the Clients tab.image

      To view the installation path, logs, and running status of the backup client on the server, see View the default installation path and logs of a Cloud Backup client.

Download and activate a Linux client

  1. Log on to the Cloud Backup console.

  2. In the navigation pane on the left, choose Backup > On-Premises File Backup. In the upper-left corner of the top menu bar, select a region, and then click Add Client.

  3. Run a command to automatically activate the Linux client.

    Choose an access method based on your network type: Internet, VPN, or leased line. Then, copy the code and run the command on the client to activate it.image

    After the client is installed, its Client Status changes to Activated on the Clients tab.

    To view the installation path, logs, and running status of the backup client on the server, see View the default installation path and logs of a Cloud Backup client.

More operations

After you install the backup client, go to the Clients tab. In the Actions column of the client, click to perform the following operations.

Operation

Description

Reactivate Client

Try this operation if the client status is abnormal. For more information, see Troubleshoot and handle file backup client status exceptions.

Delete Backup

Deletes all backup data generated by this backup client and causes any running backup or restore jobs to fail.

Important

Before you delete the client, make sure that you no longer need its backup data and that no backup or restore jobs are running on it.

Alert Settings

Specifies the method for sending alert notifications when the backup vault client or a backup or restore job is abnormal.

  • Disabled: The client stops sending alert notifications.

  • Same as Backup Vault: The client uses the same alert method as the backup vault.

  • Notify Alibaba Cloud Account: Backup alert notifications for this client are sent by email to the Alibaba Cloud account.

  • Custom: Select one or more contacts or contact groups. After the configuration is complete, the client sends backup alerts to the selected contacts or groups. For more information, see Manage alert contacts.

Client Settings

Configure client settings. The following parameters are available:

  • Use HTTPS: Enable HTTPS to encrypt data in transit. While this provides enhanced security, the encryption and decryption overhead may slightly impact performance. Changes to this setting will apply to all subsequent backup and restore jobs.

    Note

    This setting secures data in transit. Separately, all data is permanently encrypted at rest within the backup vault, regardless of your HTTPS selection.

  • Data Network: Select data transmission over a VPC or the Internet. If your client is deployed in an Alibaba Cloud virtual private cloud (VPC), or is connected to an Alibaba Cloud VPC through a leased line, select VPC as the transmission network.

  • Maximum number of worker threads: Set the maximum number of worker threads for the backup client. A higher number of threads consumes more host resources and has a greater performance impact on the host. Assess the performance impact on your host before setting this value.

  • Maximum CPU Cores: Set the maximum number of CPU cores for the backup client. A higher number of CPU cores consumes more host resources and has a greater performance impact on the host. Assess the performance impact on your host before setting this value.

  • Data Network Proxy Mode: Configure a proxy for the data network. If enabled, you must provide the following proxy server details: IP address or domain name, username, and password.

Next step

Back up local files

References