/docker-atftpd

Set up advanced TFTP server to share images via PXE

Primary LanguageDockerfileGNU General Public License v3.0GPL-3.0

publish-docker-image docker-pulls image-size

This Docker image sets up aftpd inside a docker container.

atftpd is a client/server implementation of the TFTP protocol that implements RFCs 1350, 2090, 2347, 2348, 2349 and 7440.

Installation

To use docker-atftpd, follow these steps:

  1. Clone and start the container:

    docker run -p 69:69/udp \
      docker.io/aguslr/atftpd:latest
    
  2. Configure your PXE server to connect to your TFTP server's IP address (e.g. 192.168.1.10). For example, this would be the configuration for dnsmasq:

    dhcp-match=set:bios,option:client-arch,0
    dhcp-match=set:efi32,option:client-arch,6
    dhcp-match=set:efi64,option:client-arch,7
    dhcp-match=set:efi64,option:client-arch,9
    dhcp-boot=tag:bios,grub/i386-pc/core.0,tfp.lan,192.168.1.10
    dhcp-boot=tag:efi32,grub/i386-efi/core.efi,tfp.lan,192.168.1.10
    dhcp-boot=tag:efi64,grub/x86_64-efi/core.efi,tfp.lan,192.168.1.10
    

Custom GRUB entries

To configure additional GRUB entries, we can add these to a custom.cfg file (e.g. for nextboot.xyz):

menuentry --hotkey=n "netboot.xyz" {
  if [ "$_EFI" == true ]; then
    if [ "$_ARM64" == true ]; then
      chainloader disks/netboot.xyz/boot-arm64.efi
    else
      chainloader disks/netboot.xyz/boot.efi
    fi
  else
    linux16 grub/memdisk iso raw
    initrd16 disks/netboot.xyz/boot.iso
  fi
}

We would have to copy the necessary image files into the ./disks directory so we can go ahead and mount the volumes as follows:

docker run -p 69:69/udp \
  -v "${PWD}"/disks:/data/disks \
  -v "${PWD}"/custom.cfg:/data/grub/custom.cfg \
  docker.io/aguslr/atftpd:latest

Build locally

Instead of pulling the image from a remote repository, you can build it locally:

  1. Clone the repository:

    git clone https://github.com/aguslr/docker-atftpd.git
    
  2. Change into the newly created directory and use docker-compose to build and launch the container:

    cd docker-atftpd && docker-compose up --build -d
    

References