docker container > how to see my custom ISO to boot off of

Question: I cant find my predownloaded ISO files (Kubuntu) when i PXE boot off of my docker container

I can see them in the web menu under Untracked Assets but cant find them when PXE booting from the desktop


version: “2”

services: netbootxyz:

image: linuxserver/netbootxyz

container_name: netbootxyz


  • PUID=1000

  • PGID=1000

  • MENU_VERSION=1.9.9 #optional volumes:

  • /media/username/nfsset/containers/netbootxyz/config:/config

  • /media/username/smbshare/Software/ISO/Linux/:/assets

#optional ports:

  • 3000:3000

  • 69:69/udp

  • 8080:80 #optional

restart: unless-stopped web menu

How do i boot off my Untracked Assets

I setup a docker container using

I am able to PXE boot a computer off of my docker container

If i go to on my web browser > Local Assets

I am able to see my custom ISO’s under the “Untracked Assets”

I am not able to find my custom (Kubuntu) ISO in the menu when PXE booting

What am i missing

Thanks in Advance

can you see the files when you goto ?

Yes I can see all my custom iso in that link

oh i see what you’re doing wrong here, sorry. You need to unpack the ISO and make those contents available. Your best bet is to scroll down and find kubuntu and click download. You’ll get the correct data.

So what you are saying is I cannot utilize a ISO, I have to unpack an ISO and then I’ll be able to boot off it of it… Never tried to unpack an iso you recommend any special software…thanks in advance

basically, though it’s likely much more efficient to download the assets from within the system, but yes, the pxeloader environment has no clue what to do with an ISO image

just mount the iso in the assets folder and restart the netboot container


I am working on the same project, or at least similar. In my environment, we have been designing our own ISOs with Preseeding. My test scenario would be to run this container and build an Ansible command to start it up for any site that may need a device re-imaged.

Unfortunately, we have many sites running extremely slow speeds so that’s why we want to host the ISO locally.

I am a little confused when @driz said to unpack the ISO locally, or Mount it in that directory? Do you mean extract the contents of the ISO in my linked Assets directory? Or do you mean I can write a startup script that makes sure the ISO is mounted in my Linked Assets directory at all times?

I also see my ISO in my Untracked Assets, and don’t completely understand where I am suppose to find the ISO in the menu after I PXE boot.

All help is appreciated!

Assuming you’re still talking about windows:

  1. mount your ISO (or unpack it) in a samba share
  2. Verify you can see all the files via the built in http server.
  3. boot the windows install environment
  4. enable networking
  5. mount the samba share to a drive letter
  6. run setup.exe from the share

this is basically how WDS works as well. if your links are too slow to handle this, deploy with usb?

Sorry, should have specified.

100% Debian Linux.

in this case, you dont need to mess with the ISO, just look at your assets and tell it to download the debian version stuff you want, follow the guidance (or our blog on netboot) for pointing locally

Thank you,

I have been following that guide, but the section where using Local Assets confuses me. I am trying to use it on a custom ISO I have, customized via Pre-seed. But it shows under Untracked Assets. I put the ISO into a location: /PXEassets, that was linked to the assets of the container.

Are you saying I still need to download certain stuff for Debian other than the ISO into the assets directory?

I used Docker Create:

docker create \
  --name=netbootxyz \
  -e PUID=1000 \
  -e PGID=1000 \
  -p 3000:3000 \
  -p 69:69/udp \
  -p 8080:80 \
  -v /PXEconfig:/config \
  -v /PXEassets:/assets \
  --restart unless-stopped \

browse to the site, click local assets, check the squashfs, initird, and vmlinuz you want, click pull selected.

an ISO isn’t going to work across pxe, how would it get mounted or unpacked?