|
@@ -1,19 +1,63 @@
|
|
|
## netboot.xyz - v2 - Under Construction
|
|
|
|
|
|
-** THIS IS A WORK IN PROGRESS, DO NOT USE **
|
|
|
+[](https://travis-ci.com/netbootxyz/netboot.xyz)
|
|
|
+[](https://discord.gg/An6PA2a)
|
|
|
|
|
|
-** Templates are incomplete and still being worked **
|
|
|
+
|
|
|
|
|
|
-netboot.xyz rewritten in ansible to generate standalone netboot environments.
|
|
|
+### Bootloader Downloads
|
|
|
|
|
|
-The goal is to use this to generate the primary netboot.xyz site
|
|
|
-but at the same time allow it to be customizable for any type of environment or user.
|
|
|
+#### EFI Boot Loaders
|
|
|
|
|
|
-The source files are now templates in order to make things a bit easier to generate.
|
|
|
+| Type | Bootloader | Description |
|
|
|
+|------|------------|-------------|
|
|
|
+|ISO|[netboot.xyz-efi.iso](https://boot.netboot.xyz/ipxe/netboot.xyz-efi.iso)| Same as ISO (Legacy) but used for EFI BIOS, works in Virtual Box EFI mode |
|
|
|
+|USB|[netboot.xyz-efi.usb](https://boot.netboot.xyz/ipxe/netboot.xyz-efi.usb)| Used for creation of USB Keys|
|
|
|
+|DHCP| [netboot.xyz.efi](https://boot.netboot.xyz/ipxe/netboot.xyz.efi)| DHCP EFI boot image file, uses built-in iPXE NIC drivers|
|
|
|
+|DHCP-snp|[netboot.xyz-snp.efi]() | DHCP EFI boot image file, use if you have NIC issues... need to build|
|
|
|
|
|
|
-This is a seperate repo for now but will more than likely roll into the existing repo.
|
|
|
+#### Legacy Boot Loaders
|
|
|
|
|
|
-# Building locally
|
|
|
+| Type | Bootloader | Description |
|
|
|
+|------|------------|-------------|
|
|
|
+|ISO| [netboot.xyz.iso](https://boot.netboot.xyz/ipxe/netboot.xyz.iso)| Used for CD/DVD, Virtual CDs like DRAC/iLO, VMware, Virtual Box (Legacy) |
|
|
|
+|Floppy| [netboot.xyz.dsk](https://boot.netboot.xyz/ipxe/netboot.xyz.dsk)| Used for 1.44 MB floppies, Virtual floppies like DRAC/iLO, VMware, Virtual Box|
|
|
|
+|USB| [netboot.xyz.usb](https://boot.netboot.xyz/ipxe/netboot.xyz.usb)| Used for creation of USB Keys|
|
|
|
+|Kernel| [netboot.xyz.lkrn](https://boot.netboot.xyz/ipxe/netboot.xyz.lkrn)| Used for booting from GRUB/EXTLINUX|
|
|
|
+|DHCP| [netboot.xyz.kpxe](https://boot.netboot.xyz/ipxe/netboot.xyz.kpxe)| DHCP boot image file, uses built-in iPXE NIC drivers|
|
|
|
+|DHCP-undionly| [netboot.xyz-undionly.kpxe](https://boot.netboot.xyz/ipxe/netboot.xyz-undionly.kpxe)| DHCP boot image file, use if you have NIC issues|
|
|
|
+
|
|
|
+SHA256 checksums are generated during each build of iPXE and are located [here](https://boot.netboot.xyz/ipxe/netboot.xyz-sha256-checksums.txt). You can also view the scripts that are embedded into the images [here](https://github.com/netbootxyz/netboot.xyz/tree/master/ipxe/disks).
|
|
|
+
|
|
|
+### What is netboot.xyz?
|
|
|
+
|
|
|
+[netboot.xyz](http://www.netboot.xyz) is a convenient place to boot into any type of operating system or utility disk without the need of having to go spend time retrieving the ISO just to run it. [iPXE](http://ipxe.org/) is used to provide a user friendly menu from within the BIOS that lets you easily choose the operating system you want along with any specific types of versions or bootable flags.
|
|
|
+
|
|
|
+If you already have iPXE up and running on the network, you can hit netboot.xyz at anytime by typing:
|
|
|
+
|
|
|
+ chain --autofree https://boot.netboot.xyz/ipxe/netboot.xyz.lkrn
|
|
|
+
|
|
|
+or when in EFI mode:
|
|
|
+
|
|
|
+ chain --autofree https://boot.netboot.xyz/ipxe/netboot.xyz.efi
|
|
|
+
|
|
|
+This will load the appropriate netboot.xyz kernel with all of the proper options enabled.
|
|
|
+
|
|
|
+### Documentation
|
|
|
+
|
|
|
+See [netboot.xyz](https://netboot.xyz) for all documentation. Some links to get started with are:
|
|
|
+
|
|
|
+* [Downloads](https://netboot.xyz/downloads/)
|
|
|
+* [Booting Methods](https://netboot.xyz/booting/)
|
|
|
+* [FAQ](https://netboot.xyz/faq/)
|
|
|
+
|
|
|
+If you'd like to contribute to the documentation, the netboot.xyz documenation is located at [netboot.xyz-docs](https://github.com/netbootxyz/netboot.xyz-docs).
|
|
|
+
|
|
|
+# Self Hosting netboot.xyz
|
|
|
+
|
|
|
+For those users who want to deploy their own netboot.xyz environment, you can leverage
|
|
|
+the same scripts that are used to deploy the hosted environment. The source scripts are
|
|
|
+all ansible templates and can be generated and customized to your preference.
|
|
|
|
|
|
## With Ansible
|
|
|
|
|
@@ -23,7 +67,7 @@ To generate, run:
|
|
|
ansible-playbook -i inventory site.yml
|
|
|
```
|
|
|
|
|
|
-The build output will be located in /var/www/html on Debian OSs.
|
|
|
+The build output will be located in /var/www/html by default.
|
|
|
|
|
|
## With Docker
|
|
|
|
|
@@ -45,3 +89,60 @@ Also note many user customizations are located in the boot.cfg file for the IPXE
|
|
|
## Self Hosted Custom Options
|
|
|
|
|
|
In addition to being able to host netboot.xyz locally, you can also create your own custom templates for custom menus within netboot.xyz. Please see [Custom User Menus](etc/netbootxyz/custom/README.md) for more information.
|
|
|
+
|
|
|
+## What Operating Systems are currently available on netboot.xyz?
|
|
|
+
|
|
|
+### Operating Systems
|
|
|
+
|
|
|
+| Name | URL | Installer Kernel | Live OS |
|
|
|
+|------------|-----------------|------------------|---------------|
|
|
|
+|Alpine Linux| https://alpinelinux.org | Yes | No |
|
|
|
+|Arch Linux | https://www.archlinux.org| Yes | No |
|
|
|
+|BlackArch Linux|https://blackarch.org| ISO - Memdisk | No |
|
|
|
+|CentOS| https://centos.org | Yes | No |
|
|
|
+|Debian| https://debian.org | Yes | Yes|
|
|
|
+|Devuan| https://devuan.org | Yes | No |
|
|
|
+|Elementary OS| https://elementary.io | No | Yes |
|
|
|
+|Fedora| https://fedoraproject.org | Yes | Yes |
|
|
|
+|Flatcar Linux|https://www.flatcar-linux.org| Yes | No |
|
|
|
+|FreeBSD|https://freebsd.org| No, disk image | No |
|
|
|
+|FreeDOS|http://www.freedos.org| ISO - Memdisk| No |
|
|
|
+|Gentoo|https://gentoo.org| Not Working | No |
|
|
|
+|IPFire|https://www.ipfire.org| Yes | No |
|
|
|
+|Kali Linux|https://www.kali.org| Yes | Yes |
|
|
|
+|Mageia|https://www.mageia.org| Yes | No |
|
|
|
+|Manjaro|https://manjaro.org| No | Yes |
|
|
|
+|Mint|https://linuxmint.com| No | Yes |
|
|
|
+|Microsoft Windows|https://www.microsoft.com| User supplied media | No |
|
|
|
+|MirOS|https://www.mirbsd.org| Yes | No |
|
|
|
+|NixOS|https://nixos.org| Yes | No |
|
|
|
+|OpenBSD|https://openbsd.org| Yes | No |
|
|
|
+|OpenSUSE|https://opensuse.org| Yes | No |
|
|
|
+|Parrot Security|https://www.parrotsec.org| ISO | No |
|
|
|
+|Pop OS|https://system76.com/pop| No | Yes |
|
|
|
+|RancherOS|https://rancher.com/rancher-os| Yes | No |
|
|
|
+|Red Hat Enterprise Linux|https://www.redhat.com| User supplied media | No |
|
|
|
+|Scientific Linux|https://scientificlinux.org| Yes | No |
|
|
|
+|Slackware|https://www.slackware.com| Yes | No |
|
|
|
+|Tails|https://tails.boum.org | No | Yes |
|
|
|
+|Tiny Core Linux|https://tinycorelinux.net| ISO - Memdisk | No |
|
|
|
+|Ubuntu|https://www.ubuntu.com| Yes | Yes |
|
|
|
+
|
|
|
+### Utilities
|
|
|
+
|
|
|
+| Name | URL | Installer Kernel | Live OS |
|
|
|
+|------------|-------------------------|------------------|---------|
|
|
|
+|ALT Linux Rescue|https://en.altlinux.org/Rescue| ISO - Memdisk | - |
|
|
|
+|Breakin|http://www.advancedclustering.com/products/software/breakin/| ISO - Memdisk | - |
|
|
|
+|Clonezilla|http://www.clonezilla.org/| ISO - Memdisk | - |
|
|
|
+|DBAN|http://www.dban.org/| ISO - Memdisk | - |
|
|
|
+|GParted|http://gparted.org| ISO - Memdisk | - |
|
|
|
+|Grml|http://grml.org| ISO - Memdisk | - |
|
|
|
+|Memtest|http://www.memtest.org/| Yes | - |
|
|
|
+|Super Grub2 Disk|http://www.supergrubdisk.org| ISO - Memdisk | - |
|
|
|
+|Ultimate Boot CD|http://www.ultimatebootcd.com| ISO - Memdisk | - |
|
|
|
+
|
|
|
+### Feedback
|
|
|
+
|
|
|
+Feel free to open up an [issue](https://github.com/netbootxyz/netboot.xyz/issues) on Github, swing by [Freenode IRC](http://freenode.net/) in the [#netbootxyz](http://webchat.freenode.net/?channels=#netbootxyz) channel, or ping us on [Discord](https://discord.gg/An6PA2a). Follow us on [Twitter](https://twitter.com/netbootxyz) or like us on [Facebook](https://www.facebook.com/netboot.xyz)!
|
|
|
+
|