All Products
Search
Document Center

:Reinstall the operating system

Last Updated:Dec 03, 2025

You can reinstall the operating system of an RDS Custom instance if the operating system fails, you need to clear data from the system disk, or the current operating system does not meet your requirements. This topic describes how to reinstall the operating system of an RDS Custom instance.

Prerequisites

  • Create a snapshot of the system disk to back up data. For more information, see Create a snapshot.

    Important

    Reinstalling the operating system erases all data on the original system disk. Proceed with caution.

  • The instance must be in the Suspended state. For more information, see Stop an instance.

  • If you want to use a custom image, you must first create a custom image.

Procedure

  1. Log on to the RDS Management Console. In the navigation pane on the left, click RDS Custom > Instances. Then, select a region.

  2. Click the ID of the target instance to go to the Basic Information page.

  3. On the Basic Information page, click Reinstall System. In the window that appears, configure the following parameters.

    Parameter

    Description

    Images

    Select an image as needed.

    • Reinstall Original System

    • Reselect Image

      You can select one of the following new images:

      • Default images: Base images provided by Alibaba Cloud. These images are fully licensed and include mainstream Linux operating systems.

      • Custom images.

    Security Settings

    Configure the authentication method to securely log on to the instance. The following options are available:

    • Key Pair:

      • If you have a key pair in the same region as the instance, select it.

      • If you do not have a key pair, click Create Key Pair to go to the ECS console. Create a key pair in the same region as the instance, and then select it. For more information, see Create an SSH key pair.

    • Custom Password: Enter and confirm the logon password.

    • Configure After Change: After the operating system is reinstalled, attach a key pair or reset the instance password.

  4. Click OK.

    The reinstallation takes about 2 minutes. The exact time varies based on the operating system. The reinstallation is complete when the status of the RDS Custom instance changes to Running.

Related API

To reinstall the operating system of an RDS Custom instance, call the ReplaceRCInstanceSystemDisk operation.

References

Introduction to RDS Custom