ladybird/Documentation/VMware.md
2021-07-10 23:24:45 +02:00

2.5 KiB

Serenity installation guide for VMware

NOTICE

There are currently issues with running Serenity in VMware. Please refer to the open issue for a list of currently known issues. Anything that doesn't currently work will be noted in this document.

Creating the disk image

Before creating a disk image that will work in VMware, you will need to create a GRUB image as described in the Serenity installation guide. Please skip the final step of that section, as that is only relevant for putting the image onto a real drive. You cannot use the same disk image created for QEMU. Using that image will halt immediately with the message FATAL: No bootable medium found! System halted.

The easiest way to convert the disk image is with QEMU:

qemu-img convert -O vmdk /path/to/grub_disk_image /path/to/output/serenityos.vmdk

Creating the virtual machine

Creating a SerenityOS virtual machine is similar to any other virtual machine. The main difference is using the already created VMDK disk image.

Please note that these instructions were written with VMware Player 15 in mind. Therefore, these instructions may not match exactly for past and future versions or VMware Workstation.

  1. Open the Create a New Virtual Machine dialog. Select I will install the operating system later.
  2. Choose Other as the guest operating system.
  3. Feel free to give it any name and store it anywhere.
  4. Choose any size for the hard disk. This disk will later be removed and replaced with the converted GRUB image from the previous stage.
  5. Select Finish to finalize creation of the virtual machine.
  6. Select the newly created virtual machine and click Edit virtual machine settings.
  7. Serenity requires at minimum 32 MB of memory. Set Memory for this virtual machine equal to or above 32 MB. The currently recommended size is 256 MB. Please note that Serenity is currently a 32-bit system, so anything above the ~3.5 GB mark will not be recognized.
  8. Select the existing Hard Disk and click Remove.
  9. Select Add, select Hard Disk, select IDE (Recommended), select Use an existing virtual disk.
  10. Click Browse and browse to where you stored the converted VMDK disk image from the previous stage and add it. Click Finish.
  11. Finally click Save. You can now Power On the virtual machine.

Please note that at the time of writing, audio and networking do not work in VMware.

That is all you need to boot Serenity in VMware!