mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2024-11-26 09:30:24 +00:00
36 lines
2.6 KiB
Markdown
36 lines
2.6 KiB
Markdown
|
# Serenity installation guide for VMware
|
||
|
|
|
||
|
|
## NOTICE
|
||
|
|
There are currently issues with running Serenity in VMware. Please refer to the [open issue](https://github.com/SerenityOS/serenity/issues/5716) 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](https://github.com/SerenityOS/serenity/blob/master/Documentation/INSTALL.md). 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!
|
||
|
|
|