netbootxyz

Docker app from linuxserver's Repository

Overview

Netbootxyz(https://netboot.xyz) is a way to PXE boot various operating system installers or utilities from one place within the BIOS without the need of having to go retrieve the media to run the tool. iPXE 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.

Runtime arguments

Web UI: http://[IP]:[PORT:3000]
Network: bridge
Shell: bash
Privileged: false

Template configuration

WebUIPorttcp

Web configuration interface.

Target: 3000
Default: 3000

Port: 69Portudp

TFTP Port.

Target: 69
Default: 69

Port: 80Porttcp

NGINX server for hosting assets.

Target: 80
Default: 8080

AppdataPathrw

Storage for boot menu files and web application config

Target: /config

Path: /assetsPathrw

Storage for NETBOOT.XYZ bootable assets (live CDs and other files)

Target: /assets

MENU_VERSIONVariable

Specify a specific version of boot files you want to use from NETBOOT.XYZ (unset pulls latest)

Default: 1.9.9

PORT_RANGEVariable

Specify the port range tftp will use for data transfers (see Wikipedia)(https://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol#Details)

Default: 30000:30010

SUBFOLDERVariable

Specify a subfolder if running this behind a reverse proxy (IE /proxy/)

Default: /

NGINX_PORTVariable

Specify a different internal port for the asset server

Default: 80

WEB_APP_PORTVariable

Specify a different internal port for the configuration UI

Default: 3000

PUIDVariable

Container Variable: PUID

Default: 99

PGIDVariable

Container Variable: PGID

Default: 100

UMASKVariable

Container Variable: UMASK

Default: 022

Links

Template Support Registry Project

Details

Repository

lscr.io/linuxserver/netbootxyz

Registry

https://github.com/orgs/linuxserver/packages/container/package/netbootxyz

Last Updated2025-06-16

First Seen2019-10-30

Run Netbootxyz on Unraid.

Netbootxyz is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS