Rescue Mode

    Recover your instance when you can't access the system normally

    Overview

    Rescue mode allows you to boot your instance into a minimal Linux environment to troubleshoot and repair issues when you can't access the system normally.

    When to Use Rescue Mode

    Access Issues

    • • Lost SSH access due to firewall rules
    • • Need to reset the root password

    System Issues

    • • System won't boot (filesystem corruption)
    • • Boot loader issues
    • • Need to recover files

    Entering Rescue Mode

    Step 1: Access Cloud Control Panel

    1. Log into the Cloud Control Panel
    2. Select your instance from the Instances tab

    Step 2: Boot Into Rescue Mode

    1. Click the Rescue button in the instance actions
    2. Select a rescue image (usually Ubuntu or Debian)
    3. The instance will reboot into rescue mode

    Accessing Your Disk

    Once in rescue mode, your original disk will be available as a secondary device (usually /dev/vdb or /dev/sdb). You'll need to mount it to access your files:

    # Create a mount point
    mkdir /mnt/disk
    
    # Mount your disk
    mount /dev/vdb1 /mnt/disk
    
    # Access your files
    cd /mnt/disk

    Common Rescue Tasks

    Resetting Root Password

    # Mount your disk
    mount /dev/vdb1 /mnt/disk
    
    # Chroot into your system
    chroot /mnt/disk
    
    # Reset password
    passwd root
    
    # Exit chroot
    exit
    
    # Unmount
    umount /mnt/disk

    Fixing Filesystem Issues

    # Check and repair filesystem (disk must be unmounted)
    fsck -y /dev/vdb1

    Recovering Files

    # Mount your disk
    mount /dev/vdb1 /mnt/disk
    
    # Copy files out
    scp /mnt/disk/path/to/file user@remote-host:/backup/

    Exiting Rescue Mode

    Step 1: Unmount Filesystems

    Make sure to unmount any mounted filesystems:

    umount /mnt/disk

    Step 2: Unrescue Instance

    1. In the Cloud Control Panel, click Unrescue on your instance
    2. The instance will reboot into your normal operating system

    Warning

    Always unmount filesystems before exiting rescue mode to prevent data corruption. Use umount /mnt/disk before unrescuing.