Common issues

Error: failed to start Switch Root.

error-switch-root

You probably didn't start the Prepare disk image, please do the third step again.

Black screen after starting the VM

Please ensure you are using VirtualBox 6.1 (you can check in Help -> About VirtualBox).

Not in a hypervisor partition

virt-disabled

You need to enable VT-x or AMD-V in your BIOS.

Cannot enable nested VT-x/AMD-V without nested-paging

nested

Go to the VM settings window and in the System page and Processor tab, uncheck the Enable nested Vt-x/AMD-V box.

FATAL: Could not read from the boot medium! System halted

no-boot-medium-display

This issue often happens if you tried to install VBoxGuestAdditions. The tools provided by VirtualBox are given as an ISO file. When you try to install the tools, the ISO will replace your boot device.

To fix this issue, you need to re-attach the original boot device to your VM.

Go into your VM settings (Settings -> Storage)

Warning

Be careful ! You should only edit the Controller: IDE section of the Storage settings.

In the Controller: IDE section, you will either see nothing or the VBoxGuestAdditions iso.

Controller: IDE section is empty

no-boot-medium

Click on the little CD/ROM button on the Controller: IDE line.

add-boot-iso

Choose the iso called PIE-disk001.iso, it should have a size of ~1MB.

add-boot-iso-menu

You should now be able to boot your VM.

VBoxGuestAdditions iso is present in the Controller: IDE section

guest-additions

  1. Select VBoxGuestAdditions iso.

  2. Click on the disk icon on the right of the menu.

guest-additions

Choose the iso called PIE-disk001.iso.

guest-additions

You should now be able to boot your VM.

Boot fails with "Permission denied"

error-permission-denied

This issue happens when the root TLS certificate used to sign our certificates expires. To fix this issue, it is required to update the ISO used by the VM to boot. You can download the latest version here. Simply replace the ISO used by the virtual CD drive of the VM with this one.