About this app
netboot.xyz is a PXE app: an iPXE menu that boots OS installers and utilities over the network. This Universal App wraps the official container (web UI, TFTP, local asset HTTP). It does not run DHCP; point the LAN DHCP next-server and bootfile at this host.
What this app needs
recipe.jsonSettings
No settings needed
After it starts
Imported from the Big Bear CasaOS app store and verified to start on Setup; it has not been reviewed line by line.
- From the source: This app does not run DHCP. Point the LAN's existing DHCP server at this host: - next-server / TFTP server name (option 66): this host's LAN IP - bootfile (option 67): netboot.xyz.kpxe (BIOS), netboot.xyz.efi (x86 64 UEFI), or netboot.xyz-arm64.efi (ARM64 UEFI) These boot filenames are baked into the image. Host UDP 69 must stay mapped to container 69; PXE firmware requires port 69. If another process already bound host UDP 69, TCP 3000, or TCP 8080, the container will fail to start.
Technical details
- Opens
- app:3000/
- Check
- GET / within 300 s
- app
- Image
- ghcr.io/netbootxyz/netbootxyz:0.7.6-nbxyz24
- Ports
- 3000/http69/udp80/tcp
- Data
- config → /configassets → /assets
- Internet
- Public internet, private networks blocked
- Limits
- 1 CPU · 1024 MB
Checks by Setup
No current check by Setup; runs on your own server do not change the badge.
Past checks
No checks recorded yet.
For maintainers
Share this app’s recipe and setup button.
Add Setup to your repo
[](https://usesetup.app/run?source=https%3A%2F%2Fgithub.com%2Fnetbootxyz%2Fdocker-netbootxyz)Green: Setup passed it within 30 days. Blue: CI reported a pass. Your own runners never change the badge.