netboot/etc/netbootxyz/custom
Antony Messerli 43e2f303de Add recursive to copy in readme 2021-06-17 20:13:02 -05:00
..
README.md Add recursive to copy in readme 2021-06-17 20:13:02 -05:00
custom.ipxe.j2 Add ability for self hosted custom menus (#23) 2019-11-29 16:02:15 -06:00

README.md

Custom Menus for Self Hosted netboot.xyz

This directory contains custom iPXE files that are rendered during menu generation and available from the main menu via the custom menu option.

When these options are set:

custom_generate_menus: true
custom_templates_dir: "{{ netbootxyz_conf_dir }}/custom"

the menu will add an option for custom menus and attempt to load into custom/custom.ipxe. From there custom options can be built and maintained seperately from the netboot.xyz source tree so that both menus can be updated independently.

A sample menu is provided to demonstrate how to configure and set up a menu. You can copy the custom directory from the repo:

cp -r etc/netbootxyz/custom /etc/netbootxyz/custom

If you are building via Docker, you can create a custom folder in the root source directory and then set the variable like so:

custom_generate_menus: true
custom_templates_dir: "/ansible/custom"