All Products
Search
Document Center

Cloud Backup:Restore files to an ECS instance

Last Updated:May 29, 2026

After you back up files to a backup vault, you can restore them from a recovery point if the original files are lost or corrupted. You can restore files to the source ECS instance, a new ECS instance, or an on-premises server.

Prerequisites

  • An ECS file backup has been completed, and at least one recovery point exists. For instructions, see Back up ECS files.

  • Prepare the restore destination:

    • Restore to the source ECS instance: No additional operations are required.

    • Restore to a new ECS instance: The destination instance must have a backup client installed, with its Client Status showing as Activated in the ECS File Backup. The backup client is not installed automatically.

    • Restore to an on-premises server: The destination server must have a backup client (for Linux or Windows) installed, with its Client Status showing as Activated in the On-Premises File Backup. The backup client is not installed automatically. For more information, see Download and activate a Windows client and Linux client.

Usage notes

You cannot restore socket files or hard links.

Billing

The restore feature is free of charge. However, additional fees may apply in the following scenarios:

Scenario

Additional fees

Restore to the source ECS instance

No additional fees

Restore to a new ECS instance

A software usage fee for an additional backup client.

Restore to an on-premises server

A software usage fee for an additional backup client and outbound traffic fees.

Enable virus detection during restoration

Billed based on the number of scanned files (approximately CNY 1.5 per 1,000 files).

For more information about billing, see Billing methods and billable items.

Create a restore job

  1. Log on to the Cloud Backup console.

  2. In the left-side navigation pane, choose ECS File Backup.

  3. At the top of the ECS File Backup page, select the region of the target ECS instance.

  4. Find the target ECS instance and click View Details in the Actions column.

  5. In the Backup History section, find the target recovery point and click Restore in the Actions column.

    Note
    • You can also click the image icon on the right side of the backup history to switch to the timeline view, select a recovery point, and then click Restore. Data can vary between recovery points, so ensure you select the correct one.

    • If you are using the old console (indicated by a Try New Version button in the upper-right corner), you can perform the same operation by clicking the image icon next to the target instance on the Backup Plans tab.

  6. In the Create Restore Job panel, complete the three-step wizard.

    1. Step 1: Select restore items

      Configure the scope of files to restore, and then click Next.

      Parameter

      Description

      Restore Items

      Select the scope of files to restore. The following options are mutually exclusive:

      • Include All Files: Restores all files from the source client.

      • Include Files: Restores only the selected files or folders. You can also click Enter Paths to manually enter file paths.

      • Exclude Files: Excludes the selected files or folders and restores all others.

      Note

      When you use the Enter Paths, enter one path per line. Each path must start with the last folder of the source backup path. For example, if the backup path is /opt/data, to restore file.txt and abc.png located in the data directory, enter the paths in the following format:

      /data/file.txt
      /data/abc.png
    2. Step 2: Restore destination

      Configure the destination for the restore, and then click Next.

      Parameter

      Description

      Destination Type

      Select the type of destination client:

      • ECS Client: Select this to restore files to the source ECS instance or a new ECS instance.

      • On-premises Client: Select this to restore files to an on-premises server.

      Backup Client Name/ID

      Select the destination client. Only clients whose Client Status is Activated are displayed.

    3. Step 3: Destination path

      Configure the destination path and policies, and then click Start to Restore.

      Parameter

      Description

      Restore Path Type

      • Specify Path: Restore to a custom path. If you select this option, you must specify the destination path.

      • Origin Path: Restore to the original path where the files were located at the time of backup.

      Destination Path

      This parameter is required only if Restore Path Type is set to Specify Path. Enter the target restore path.

      Important

      The destination path must exist before you start. The restore job will fail if the directory is missing because it is not created automatically.

      File Conflict Policy

      Specifies the action to take if a file with the same name already exists in the destination path:

      • Skip This File (Default): Skips the conflicting file.

      • Overwrite The File: Overwrites the existing file in the destination path.

      • Compare update times (accurate to the second) and retain the latest version.: Compares the update times of the files (to the second) and keeps only the newer version.

      Virus Detection During Restoration

      This feature is disabled by default. If enabled, Cloud Backup performs virus detection on all files to be restored.

      Important

      Virus detection is a paid feature. For more information, see Billing methods and billable items.

      When Recovery Items Contain Detected Viruses

      • Do not restore virus-infected files (You can find secure versions on the Virus Detection page.)

      • I am aware of the risks and still want to restore all the selected items

View restore progress

After the restore job is created, you can view its progress in the Status column on the Restore Jobs tab.

When the status changes to Completed (100%), you can log on to the destination ECS instance or on-premises server to view the restored files.

Troubleshooting

Symptom

Possible cause

Solution

Abnormal Client Status

The backup client is running abnormally or is not activated.

Check the client's status and ensure its Client Status is Activated. For more information, see Troubleshoot file backup client status issues.

Restore job status is Failed

Configuration error or client exception.

  1. Verify that the configuration is correct.

  2. Check the client's status.

  3. View the logs to find the error code.

Restore job status is Partially Completed

Some files failed to be restored.

Download the list of failed files, use the error messages to resolve the issues, and then rerun the restore job.

Note

The Cloud Backup client is installed in one of the following paths by default. The following paths are for reference only. The actual installation path may be different.

  • On Windows, you can view the logs in the C:\Program Files\Aliyun Hybrid Backup Service Client\logs path.

  • On Linux, you can view the logs in the /opt/alibabacloud/hbrclient/logs path.

References