This layer creates a new supplementary initrd image which can be downloaded through TFTP with the kernel. At boot time, the init script will try to mount the rootfs based on the following kernel command line parameters: * nbd.server: IP address to reach the NBD server * nbd device to use (default: /dev/nbd0) * nbd.debug: activate debug mode (init script is then interruptible) For nbd v2: * nbd.port: TCP port on which server is listening (default: 10809) For nbd v3: * nbd.namev3: The name of the image served by nbd-server. The layer meta-netboot contains recipes for the following components: * busybox: activate the built-in NBD client * initramfs-netboot: contains the init script started by the kernel: basically, this script mounts the real root filesystem, then pivot_root on it and finally exec systemd. * initramfs-netboot-image: image to specify for building the initrd To enable the build of the netboot initrd and ext4 rootfs, add the following line in conf/local.conf: INHERIT += "netboot"

Setup information Mailing list

Git repository web repo

(actual branch next)



Last commit: 1 week, 2 days ago (next branch)


  • Jan-Simon Möller email


The meta-netboot layer depends upon:

Recipe name Version Description
initramfs-netboot 1.0 Extremely basic live image init script
initramfs-netboot-image 1.0
resolv-conf-relabel 1.0 System unit to relabel resolve.conf
Date/time Errors Warnings
June 13, 2024, 9:02 a.m.
June 11, 2024, 3:02 p.m.
June 10, 2024, 12:02 p.m.
June 4, 2024, 6:01 p.m.
May 30, 2024, 12:03 a.m.
May 28, 2024, 3:01 p.m.
May 24, 2024, 3:01 p.m.
May 23, 2024, 3:01 p.m.