netboot.xyz/etc/netbootxyz/custom/README.md
2021-06-17 20:13:02 -05:00

32 lines
945 B
Markdown

# 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"
```