Jump toUpdate content

How to use rescue mode on a server

Reviewed on 19 September 2023Published on 11 June 2021

The rescue mode system is a minimal operating system for your server, booted on demand over the network. If your server does not boot, and you need to modify some files to fix the issue, rescue mode allows you to do so. We recommend using rescue mode if your Dedibox server:

  • does not boot after you have rebooted it (no ping, following to a FSCK error for example)
  • boots, but is not reachable because of a misconfiguration of the firewall
  • Does not boot after a kernel upgrade
  • Does not boot following a modification of the bootloader configuration (Grub, lilo, …)
  • does not boot following an update of the operating system
  • is generally unavailable on the Internet after booting, for any other reason

Currently, we offer three different types of rescue modes:


How to launch rescue mode

  1. From the console, click Server > Server list on the top menu. A list of your servers displays.
  2. Click Manage next to the relevant server.
  3. Click Rescue.
  4. Select the rescue mode that corresponds to the OS you have installed on the server.
  5. Click Click here to launch rescue mode.

How to access rescue mode for Linux/FreeBSD

To access your server once you have launched Linux/FreeBSD rescue mode, follow these steps:

  1. Connect to your server via SSH

  2. Use the login and password given on the status page of the server in the console. Bear in mind that rescue mode usually needs about two minutes to initialize.

    Once you are connected, you can use rescue mode like a normal distribution, and install your favorite tools including text editors or FTP clients. The only limitation is the size of the ramdisk.

How to access rescue mode for Windows

The only way to access your server in Windows PE rescue mode once launched, is via the KVM/IP of your server. Refer to the KVM/IP documentation that corresponds to your server model.

See Also