Skip to content

Commit 370ba9f

Browse files
committed
Update boot from vm docs
1 parent f55acf6 commit 370ba9f

File tree

5 files changed

+91
-81
lines changed

5 files changed

+91
-81
lines changed

docs/booting/grub.md

Lines changed: 0 additions & 48 deletions
This file was deleted.

docs/booting/ipxe.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
id: ipxe
33
title: Boot from iPXE
44
sidebar_label: Boot from iPXE
5-
sidebar_position: 4
5+
sidebar_position: 5
66
description: "Details how to chainload into netboot.xyz from iPXE"
77
hide_table_of_contents: true
88
---

docs/booting/uefi.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
id: uefi
33
title: Booting from a Local UEFI Executable
44
sidebar_label: Boot from UEFI
5-
sidebar_position: 8
5+
sidebar_position: 4
66
description: "How to use a local UEFI executable to boot into netboot.xyz"
77
hide_table_of_contents: true
88
---

docs/booting/vms.md

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
---
2+
id: vms
3+
title: Boot from VMs
4+
sidebar_label: Boot from VMs
5+
sidebar_position: 7
6+
description: "Using netboot.xyz with various Virtualization Machine Platforms"
7+
hide_table_of_contents: false
8+
---
9+
10+
## VMware Fusion
11+
12+
These instructions are for setting up netboot.xyz in a VM on VMware's Fusion for MacOS.
13+
14+
### Create the VM
15+
16+
* Add a new virtual machine.
17+
* Select "Install from disc or image".
18+
* Click on "Use another disk or disc image...".
19+
* Download and select the netboot.xyz [ISO](https://boot.netboot.xyz/ipxe/netboot.xyz.iso).
20+
* 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.
21+
* Click the "Customize Settings" and give the VM a name, like "netboot.xyz".
22+
23+
This will create your VM.
24+
25+
### Running the VM
26+
27+
_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._
28+
29+
* Click the wrench icon and click on Processors & Memory and bump up the memory to the desired amount of memory.
30+
* Start the VM up and you should see the netboot.xyz loader.
31+
* 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.
32+
33+
## Proxmox VE
34+
35+
These instructions are for setting up netboot.xyz in a VM on Proxmox VE.
36+
37+
### Create the VM
38+
39+
* Log in to the Proxmox web interface.
40+
* Click on "Create VM" in the top right corner.
41+
* Give the VM a name, like "netboot.xyz", and click "Next".
42+
* On the OS tab, select "Do not use any media" and click "Next".
43+
* 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".
44+
* 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".
45+
* On the CPU tab, allocate the desired number of cores and click "Next".
46+
* On the Memory tab, allocate the desired amount of memory (e.g., 2GB to 4GB) and click "Next".
47+
* On the Network tab, leave the defaults and click "Next".
48+
* On the Confirm tab, review the settings and click "Finish".
49+
50+
### Upload the ISO
51+
52+
* Click on the "local" storage in the left sidebar.
53+
* Click on the "ISO Images" tab.
54+
* Click "Upload" and select the netboot.xyz [ISO](https://boot.netboot.xyz/ipxe/netboot.xyz.iso) file to upload.
55+
56+
### Attach the ISO and Boot
57+
58+
* Select the newly created VM from the left sidebar.
59+
* Click on the "Hardware" tab.
60+
* Click "Add" and select "CD/DVD Drive".
61+
* Choose "Use CD/DVD disc image file (iso)" and select the uploaded netboot.xyz ISO.
62+
* Click "OK".
63+
* Click on the "Options" tab.
64+
* Double-click "Boot Order" and ensure the CD/DVD drive is set to boot first.
65+
* Start the VM and you should see the netboot.xyz loader.
66+
67+
## Hyper-V
68+
69+
These instructions are for setting up netboot.xyz in a VM on Hyper-V.
70+
71+
### Create the VM
72+
73+
* Open Hyper-V Manager.
74+
* Click on "New" and select "Virtual Machine".
75+
* Click "Next" on the Before You Begin screen.
76+
* Give the VM a name, like "netboot.xyz", and click "Next".
77+
* Choose "Generation 1" and click "Next".
78+
* Allocate the desired amount of memory (e.g., 2GB to 4GB) and click "Next".
79+
* Configure the network settings and click "Next".
80+
* 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".
81+
* 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).
82+
* Click "Finish".
83+
84+
### Running the VM
85+
86+
* Right-click on the newly created VM and select "Settings".
87+
* Adjust the memory settings if needed.
88+
* Start the VM and you should see the netboot.xyz loader.
89+
* 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.

docs/booting/vmware.md

Lines changed: 0 additions & 31 deletions
This file was deleted.

0 commit comments

Comments
 (0)