From 370ba9fc71509a76ad37ab6d2915f25837150a17 Mon Sep 17 00:00:00 2001 From: Antony Messerli Date: Thu, 13 Feb 2025 00:57:17 -0600 Subject: [PATCH] Update boot from vm docs --- docs/booting/grub.md | 48 ----------------------- docs/booting/ipxe.md | 2 +- docs/booting/uefi.md | 2 +- docs/booting/vms.md | 89 ++++++++++++++++++++++++++++++++++++++++++ docs/booting/vmware.md | 31 --------------- 5 files changed, 91 insertions(+), 81 deletions(-) delete mode 100644 docs/booting/grub.md create mode 100644 docs/booting/vms.md delete mode 100644 docs/booting/vmware.md diff --git a/docs/booting/grub.md b/docs/booting/grub.md deleted file mode 100644 index 2e8c6b4..0000000 --- a/docs/booting/grub.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -id: grub -title: Booting from an existing Linux installation using GRUB -sidebar_label: Boot from GRUB -sidebar_position: 5 -description: "How to use GRUB to boot into netboot.xyz" -hide_table_of_contents: true ---- - -If you have an existing Linux system where you are unable to use iPXE or boot from a disk image, but you can see the GRUB menu on boot, you can boot into netboot.xyz using `grub-imageboot`. - -## Debian and Ubuntu Based Systems - -```bash -# Install grub-imageboot -apt install grub-imageboot - -# Download netboot.xyz ISO -mkdir /boot/images -cd /boot/images -wget https://boot.netboot.xyz/ipxe/netboot.xyz.iso - -# Update GRUB menu to include this ISO -update-grub2 -reboot -``` - -## Red Hat Based Systems - -```shell -yum install syslinux wget -y -cp /usr/share/syslinux/memdisk /boot/memdisk -mkdir /boot/images -cd /boot/images -wget https://boot.netboot.xyz/ipxe/netboot.xyz.iso -ln -s /usr/share/grub/grub-mkconfig_lib /usr/lib/grub/grub-mkconfig_lib -#Download imageboot config file -wget https://raw.githubusercontent.com/formorer/grub-imageboot/529ac5d2bf91e7da8c31b9e15f37702127bddc1c/bin/60_grub-imageboot -O /etc/grub.d/60_grub-imageboot -chmod 755 /etc/grub.d/60_grub-imageboot -grub2-mkconfig -o /boot/grub2/grub.cfg -reboot -``` - -After reboot, select "Bootable ISO Image: netboot.xyz" in the GRUB menu. - -If the GRUB menu disappears too quickly, you may need to edit `/etc/default/grub` and increase the `GRUB_TIMEOUT`. Run `update-grub2` any time you modify this file. - - diff --git a/docs/booting/ipxe.md b/docs/booting/ipxe.md index 88919f3..395f6c7 100644 --- a/docs/booting/ipxe.md +++ b/docs/booting/ipxe.md @@ -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 --- diff --git a/docs/booting/uefi.md b/docs/booting/uefi.md index 84e162a..ba188f8 100644 --- a/docs/booting/uefi.md +++ b/docs/booting/uefi.md @@ -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 --- diff --git a/docs/booting/vms.md b/docs/booting/vms.md new file mode 100644 index 0000000..5378db8 --- /dev/null +++ b/docs/booting/vms.md @@ -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. diff --git a/docs/booting/vmware.md b/docs/booting/vmware.md deleted file mode 100644 index 932c6f3..0000000 --- a/docs/booting/vmware.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -id: vmware -title: Boot with VMware -sidebar_label: Boot with VMware -sidebar_position: 7 -description: "Using netboot.xyz in VMware to install a VM" -hide_table_of_contents: true ---- - -### 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.