Skip to content

Commit

Permalink
Update boot from vm docs
Browse files Browse the repository at this point in the history
  • Loading branch information
antonym committed Feb 13, 2025
1 parent f55acf6 commit 370ba9f
Show file tree
Hide file tree
Showing 5 changed files with 91 additions and 81 deletions.
48 changes: 0 additions & 48 deletions docs/booting/grub.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/booting/ipxe.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
id: ipxe
title: Boot from iPXE
sidebar_label: Boot from iPXE
sidebar_position: 4
sidebar_position: 5
description: "Details how to chainload into netboot.xyz from iPXE"
hide_table_of_contents: true
---
Expand Down
2 changes: 1 addition & 1 deletion docs/booting/uefi.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
id: uefi
title: Booting from a Local UEFI Executable
sidebar_label: Boot from UEFI
sidebar_position: 8
sidebar_position: 4
description: "How to use a local UEFI executable to boot into netboot.xyz"
hide_table_of_contents: true
---
Expand Down
89 changes: 89 additions & 0 deletions docs/booting/vms.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
---
id: vms
title: Boot from VMs
sidebar_label: Boot from VMs
sidebar_position: 7
description: "Using netboot.xyz with various Virtualization Machine Platforms"
hide_table_of_contents: false
---

## VMware Fusion

These instructions are for setting up netboot.xyz in a VM on VMware's Fusion for MacOS.

### Create the VM

* Add a new virtual machine.
* Select "Install from disc or image".
* Click on "Use another disk or disc image...".
* Download and select the netboot.xyz [ISO](https://boot.netboot.xyz/ipxe/netboot.xyz.iso).
* On the Choose Operating System Screen, select the OS type you are planning on installing. If you plan on testing multiple types of installs, you can just choose a CentOS 64-bit OS.
* Click the "Customize Settings" and give the VM a name, like "netboot.xyz".

This will create your VM.

### Running the VM

_You'll need to adjust the memory settings of the VM to ensure you'll have enough memory to run the OS installers in memory. Typically it's good to bump the memory up to 2GB to 4GB._

* Click the wrench icon and click on Processors & Memory and bump up the memory to the desired amount of memory.
* Start the VM up and you should see the netboot.xyz loader.
* If you determine you no longer want to boot from netboot.xyz, you can either change the boot order to boot from the hard drive by default or delete the ISO from the VM.

## Proxmox VE

These instructions are for setting up netboot.xyz in a VM on Proxmox VE.

### Create the VM

* Log in to the Proxmox web interface.
* Click on "Create VM" in the top right corner.
* Give the VM a name, like "netboot.xyz", and click "Next".
* On the OS tab, select "Do not use any media" and click "Next".
* On the System tab, select "OVMF (UEFI)" for the BIOS, add an EFI disk, select, the EFI Storage, and uncheck "Pre-Enroll Keys", then click "Next".
* On the Hard Disk tab, set the Disk size to a small value (e.g., 4GB) since netboot.xyz does not require much space, and click "Next".
* On the CPU tab, allocate the desired number of cores and click "Next".
* On the Memory tab, allocate the desired amount of memory (e.g., 2GB to 4GB) and click "Next".
* On the Network tab, leave the defaults and click "Next".
* On the Confirm tab, review the settings and click "Finish".

### Upload the ISO

* Click on the "local" storage in the left sidebar.
* Click on the "ISO Images" tab.
* Click "Upload" and select the netboot.xyz [ISO](https://boot.netboot.xyz/ipxe/netboot.xyz.iso) file to upload.

### Attach the ISO and Boot

* Select the newly created VM from the left sidebar.
* Click on the "Hardware" tab.
* Click "Add" and select "CD/DVD Drive".
* Choose "Use CD/DVD disc image file (iso)" and select the uploaded netboot.xyz ISO.
* Click "OK".
* Click on the "Options" tab.
* Double-click "Boot Order" and ensure the CD/DVD drive is set to boot first.
* Start the VM and you should see the netboot.xyz loader.

## Hyper-V

These instructions are for setting up netboot.xyz in a VM on Hyper-V.

### Create the VM

* Open Hyper-V Manager.
* Click on "New" and select "Virtual Machine".
* Click "Next" on the Before You Begin screen.
* Give the VM a name, like "netboot.xyz", and click "Next".
* Choose "Generation 1" and click "Next".
* Allocate the desired amount of memory (e.g., 2GB to 4GB) and click "Next".
* Configure the network settings and click "Next".
* Choose "Create a virtual hard disk" and set the Disk size to a small value (e.g., 4GB) since netboot.xyz does not require much space, and click "Next".
* Choose "Install an operating system from a bootable CD/DVD-ROM" and select the netboot.xyz [ISO](https://boot.netboot.xyz/ipxe/netboot.xyz.iso).
* Click "Finish".

### Running the VM

* Right-click on the newly created VM and select "Settings".
* Adjust the memory settings if needed.
* Start the VM and you should see the netboot.xyz loader.
* If you determine you no longer want to boot from netboot.xyz, you can either change the boot order to boot from the hard drive by default or remove the ISO from the VM.
31 changes: 0 additions & 31 deletions docs/booting/vmware.md

This file was deleted.

0 comments on commit 370ba9f

Please sign in to comment.