Checking the filesystem

If your server fails to boot or shows filesystem errors, you can run a filesystem check via the rescue system.

Note: Always create a Snapshot or Backup before running repair operations, as filesystem repairs can in rare cases lead to data loss.

1. Enable the rescue system

   As explained in this getting started:

   • Select the server
   • Navigate to "Rescue" and click on "Enable rescue & power cycle"
   • After the reboot, connect to the server as root user.

2. Check mounts

   Make sure the disk is not mounted before running the check. If you mounted it earlier, unmount it first:

   umount /mnt

   Run lsblk and identify the names of the partitions (e.g. sda1). In the steps below, replace sda1 with the name of your partitions.

3. Check filesystems

   • Primary disk

     fsck -y /dev/sda1

     The -y flag automatically answers "yes" to all repair prompts. For a more cautious approach, omit -y and confirm each fix manually.
   
   

   • Other filesystems

     Use the matching tool:

     Filesystem	Tool
     ext2/3/4	fsck.ext4 /dev/sda1
     XFS	xfs_repair /dev/sda1
     Btrfs	btrfs check --repair /dev/sda1

4. Restart the server

   Restart your server to leave the rescue system:

   reboot

After reboot, you should be able to log in the normal system again.