mirror of
https://github.com/GeekOops/geekoops-next.git
synced 2024-05-19 13:32:22 +00:00
56 lines
1.8 KiB
Markdown
56 lines
1.8 KiB
Markdown
[![Test deployment](https://github.com/GeekOops/geekoops-next/actions/workflows/CI.yml/badge.svg)](https://github.com/GeekOops/geekoops-next/actions/workflows/CI.yml)
|
|
|
|
# geekoops-next
|
|
|
|
Install and configure a NEXT (Network Boot) server using `dnsmasq`.
|
|
|
|
Note: EFI boot is not yet working (missing files in ``next.tar.gz`).
|
|
|
|
## Role Variables
|
|
|
|
|
|
| Value | Description | Default |
|
|
|-------|-------------|---------|
|
|
|`dns_port`| DNS port to use | 0 (disabled) |
|
|
|`dhcp_no_override` | Set `dhcp_no_override` for compatability with old clients | true |
|
|
|`dhcp_boot` | Set PXE boot file | `pxelinux.0` |
|
|
|`prompt` | Set boot prompt test | "geekoops-next Network boot" |
|
|
|`prompt_timeout` | Set boot prompt timeout in seconds | 2 |
|
|
|`legacy` | Use legacy boot | true |
|
|
|`efi` | Use EFI boot (not yet working) | true |
|
|
|`dhcp_range` | `dhcp_range` directive for `dnsmasq` | "" (disabled) |
|
|
|`config_firewall` | Configure firewall | false |
|
|
|`firewall_zone` | Firewall zone to configure | "public" |
|
|
|
|
## Example Playbook
|
|
|
|
- hosts: jellyfish
|
|
roles:
|
|
- { role: geekoops-next }
|
|
|
|
More extended example, where we use "192.168.122.1" as DHCP server (i.e. the NEXT server is only DHCP proxy). This works well in case you want to use an external DHCP server and use another machine as NEXT server without providing DHCP.
|
|
|
|
- hosts: jellyfish
|
|
roles:
|
|
- role: geekoops-next
|
|
vars:
|
|
config_firewall: true
|
|
firewall_zone: "public"
|
|
dhcp_range: "192.168.122.1,proxy,255.255.255.0"
|
|
prompt: "My awesome network boot server"
|
|
|
|
## License
|
|
|
|
MIT
|
|
|
|
## Author Information
|
|
|
|
phoenix
|
|
|
|
Have a lot of fun!
|
|
|
|
# Development
|
|
|
|
## syslinux
|
|
|
|
Get the latest `syslinux` from [kernel.org/ ... /syslinux](https://kernel.org/pub/linux/utils/boot/syslinux/) |