Back
VPS

Boot into rescue mode

Boot your Victus VPS into a rescue environment to repair a broken boot, fix fstab, reset the root password, or recover files when the OS will not start.

rescue moderecoveryrepairchrootfstabwont boot

Rescue mode boots your VPS from a small recovery OS instead of your installed system, leaving your real disk unmounted and untouched. From there you can mount the disk, chroot into it, and repair problems that stop the machine booting normally — a broken /etc/fstab, a bad kernel, a lost root password, or a full disk.

Enter rescue mode

  1. 1Open the VPS at control.victuscloud.com.
  2. 2From the VPS controls, switch the boot mode to Rescue and reboot the machine.
  3. 3Note the temporary rescue credentials shown in the panel, then connect via SSH or the browser console.
  4. 4You are now in the rescue OS — your real disk is present but not mounted.

Mount your disk and chroot

bash
# Find your root partition
lsblk

# Mount it (adjust device as needed)
mount /dev/vda1 /mnt

# Bind the virtual filesystems so the chroot works fully
for d in dev proc sys run; do mount --rbind /$d /mnt/$d; done

# Enter your installed system
chroot /mnt /bin/bash

Inside the chroot you are effectively "in" your broken system and can fix it — reset the root password, edit config files, reinstall a package, or repair the bootloader.

  • Reset root password: run passwd root.
  • Fix a bad mount entry: edit /etc/fstab and comment out the offending line.
  • Free space on a full root disk: delete large files in /var/log or old packages.
  • Repair a corrupt ext4 filesystem: exit the chroot, unmount, then run fsck -y /dev/vda1.

Run fsck on an UNmounted disk

Never run fsck on a mounted filesystem — it can corrupt data. Unmount /mnt first (exit the chroot, "umount -R /mnt"), then fsck the raw device.

Switch boot mode back to disk

When you are done, exit the chroot, unmount, and set the boot mode back to Normal/Disk in the panel before rebooting — otherwise the VPS boots straight back into rescue mode.

Related in VPS

First login over SSH (find your IP + root password)Locate your Victus VPS IP address and root password in the control panel, then connect over SSH from Windows, macOS or Linux for the first time.Reset the root passwordChange your Victus VPS root password from inside the machine, or reset it from the panel or rescue mode if you are locked out.Reinstall / rebuild the OSWipe your Victus VPS and reinstall a fresh Ubuntu template from the control panel, including how to back up first and what survives.Open firewall ports (ufw)Use ufw on your Victus Ubuntu VPS to open the ports your apps need — web, game and custom services — without locking yourself out of SSH.Cannot connect / SSH connection refusedDiagnose and fix the common reasons an SSH connection to your Victus VPS is refused, times out, or rejects your password/key.Resize the disk after an upgradeAfter upgrading your Victus VPS plan the virtual disk grows, but Linux needs the partition and filesystem expanded to actually use the new space.Create and restore snapshotsTake point-in-time snapshots of your Victus VPS before risky changes and roll back to them from the panel if something breaks.Mount a custom ISOAttach and boot your Victus VPS from a custom ISO to install an operating system that is not offered as a stock template.IPv6 networking basicsUnderstand and configure the IPv6 address on your Victus VPS — find your address, test connectivity, and bind services to IPv6.Install a one-click appDeploy common software on your Victus VPS in minutes using the one-click app installer in the control panel.Check CPU/RAM/disk usageMonitor CPU, memory and disk usage on your Victus VPS from the panel graphs and with standard Linux commands to spot bottlenecks.Add a swap fileAdd a swap file to your Victus VPS to survive memory spikes and avoid the OOM killer when RAM is tight.