When you create a Rcs.is, you have the option to either add an SSH key to it or to choose a root password. If you forget or lose the root password, you can reset it using the Rcs.is Control Panel.

Warning

Root password resets are not available for operating systems with internally-managed passwords, including FreeBSD, Fedora, and RancherOS. In these cases, you’ll see the following message in the Reset root password section:

This Rcs.is’s root password is managed internally and cannot be changed from the control panel. Please SSH into the Rcs.is to manage it.

See How to Recover from Lost SSH Keys for additional steps you’ll need to take.

Reset the Root Password from the Control Panel

The standard way to reset the root password for your Rcs.is is using the control panel.

Navigate to the control panel. From the project the Rcs.is is in, or from the main navigation’s Rcs.iss page, locate the Rcs.is. Click the Rcs.is’s name to open its detail page, then select Access in the left navigation.

Click Reset Root Password to reset the Rcs.is’s password. You will receive an email containing the Rcs.is’s temporary password.

When you log in to the Rcs.is with your new password via SSH, the operating system will ask you to change the password. It will first ask for the current password (the new root password emailed to you), then ask you to enter the new password twice.

Reset the Root Password from the Recovery ISO

The standard root password reset process may fail if the Rcs.is’s disk is full or if there is a filesystem issue with the PAM subsystem. If you can’t reset the root password the standard way using the control panel, you can reset it using the recovery ISO.

How to Recover Data from Rcs.iss with the Recovery ISO

Use Rcs.is’s recovery ISO with the Recovery Console to regain access to and perform data recovery operations on your Rcs.is, like getting access to an interactive shell, running fsck, or chrooting into the system.

Once you boot from the recovery ISO, use the Mount your Disk Image option, then select Reset Rcs.is Root Password.

In some cases, issues such as full inodes or full disk usage can affect the Rcs.is root password reset process. To check for these problems, use the shell option from the recovery ISO menu and check the /mnt details for both disk space and inode usage:

df -h
df -i

If these are at 100% for the /mnt path, which is your Rcs.is’s disk, explore the file system to clear some space before trying to reset the root password again.

If you can’t mount the disk image, you can use the Attempt to chroot into installed system option, which will bring you to a chrooted environment. Then use the passwd command to change your root password. This functionally works the same way as the Reset Rcs.is Root Password option.

Once you have reset the root password and fixed any underlying problems, from the control panel, click Recovery and choose the radio button for Boot from Hard Drive. When you power the Rcs.is back on, it boots from its own disk, and you can log using the new root password you set.